先认清你手里的是什么

在常见的本地图像工作流里,模型权重、节点程序和工作流文件是不同的东西。下载其中一项,通常不会自动得到另外两项。

你拿到的东西它负责什么接下来核对什么
模型权重文件提供某一种生成或处理能力对应的模型类型、加载节点和存放位置
节点或节点包提供一个或一组操作步骤ComfyUI 版本、节点来源和依赖
工作流 JSON记录节点、连接和参数它需要的模型、节点及输入素材

例如,模型文件通常由加载节点选择;更换模型时,也要核对工作流是否支持它的模型体系。文件能出现在列表里,并不能保证它适配当前流程。

参考:工作流、节点、模型

它们怎样一起完成一张图片

在一类常见的扩散模型文生图流程中,加载节点把模型传给采样步骤;文字编码步骤提供提示词条件;采样结果经解码后,才能交给保存图片的节点。实际连接还可能包括初始潜空间、负面条件等输入。

  1. 读取模型与输入
  2. 编码与采样
  3. 解码为图片
  4. 保存结果

上图只说明处理顺序,不是可直接导入运行的完整工作流。不同模型和任务可能使用不同节点。

连接线传递的是数据。一个节点输出的类型,要与下一个节点要求的输入匹配。因此,排查流程时要看输入输出,而不只是看节点是否连在一起。

参考:工作流、节点

为什么导入工作流后还不能运行

JSON 主要保存流程结构与设置。要复现别人的工作流,仍可能需要它引用的模型、输入图片、自定义节点,以及节点运行所需的软件依赖。

  • 先确认输入:有没有需要上传的图片、音频或其他素材?
  • 再确认模型:文件是否齐全,加载节点是否选到了正确的文件?
  • 再确认节点:当前安装是否包含这份工作流使用的节点?
  • 最后看运行环境:节点版本和依赖是否匹配,启动日志有没有报错?

这是一份核对顺序。遇到具体报错时,还应结合节点作者和模型项目的说明;不要仅凭“缺少模型”或“缺少节点”的印象反复更换整套环境。

参考:模型、依赖

看到问题后,先检查哪一层

现象先检查判断边界
导入后提示缺失节点节点名称、来源、ComfyUI 与节点版本也可能是节点加载失败,需看启动日志
加载节点找不到模型模型位置、类型及节点选择不同节点包可能使用不同目录或加载方式
输入或连接报错端口类型、必填输入和流程要求不能靠连接颜色或节点位置单独判断
能够运行,但效果不一致模型版本、参数、输入和工作流差异运行成功只说明流程完成,不代表复现成功

保留原工作流,每次只调整一个与报错有关的条件,并记录变化,通常更容易找到真正的差异。效果复现还需要具体任务的对照测试。

参考:节点、模型、依赖

打开一份新工作流前的检查单

  • 说清任务:这份流程最终生成或处理什么?
  • 找到来源:是否有作者说明、适用版本和依赖清单?
  • 备齐输入:模型与素材是否满足要求?
  • 先用原示例跑通:再逐项替换自己的输入和设置。
  • 记录结果:保存工作流、使用版本和输出,便于之后复现。

本文帮助你理解概念和排查方向,依据官方资料整理;没有把某一套本地环境的运行效果写成通用保证。界面、节点名称与安装方式请以当前版本和对应项目说明为准。

参考:工作流、依赖

资料来源

以下为 ComfyUI 官方文档。本文以概念说明为主,具体操作以所用版本和对应项目说明为准。

  1. ComfyUI 官方文档:工作流
  2. ComfyUI 官方文档:节点
  3. ComfyUI 官方文档:模型
  4. ComfyUI 官方文档:依赖

首次整理于 2026-10-20。没有进行本文对应的本地模型运行测试。

继续查阅相关方法

查看其他图文教程,或回到首页浏览工具。

查看图文教程