基础入门
ComfyUI 节点是什么：新手理解工作流的最短路径
节点就是一个个处理步骤，连起来就是工作流。
一句话结论
看到复杂工作流时，你能先按数据流拆开，而不是被满屏连线吓住。
这篇解决什么问题
ComfyUI 的核心不是按钮，而是节点。每个节点做一件事：加载模型、编码文本、采样、解码图片。节点连起来就是工作流。
如果你是第一次接触 ComfyUI，建议不要跳步。先把最小流程跑通，再安装插件、导入复杂工作流或追求高分辨率。ComfyUI 的大多数问题都可以通过“看控制台日志、确认目录、确认版本、降低参数”这四件事定位。
适合谁
- 刚开始使用 ComfyUI，需要一篇可以照着做的教程。
- 已经遇到相关报错，但不知道该先检查哪一步。
- 想把安装、模型、插件、工作流整理成可复查流程的用户。
准备条件
- 打开一个基础文生图工作流。
- 能看到节点上的输入口和输出口。
你可以先把节点理解成流水线：输入节点提供材料，处理节点加工，输出节点保存结果。线连错了，流程就不会按预期工作。
操作步骤
- 从左到右看：模型和提示词通常在左边，采样在中间，保存图片在右边。
- 看节点标题：Load Checkpoint 是加载模型，CLIP Text Encode 是把文字变成条件，KSampler 是生成潜空间图像。
- 看连线颜色和端口名称，MODEL、CLIP、VAE、LATENT、IMAGE 不能随便混接。
- 先理解主链路，再看旁路控制，例如 ControlNet、LoRA、IPAdapter。
- 遇到红色节点，先读节点缺失提示，再用 Manager 安装。
判断问题属于哪一类
- 如果页面打不开，先看启动窗口是否还在运行，以及端口是否正确。
- 如果节点是红色，优先处理缺失自定义节点或插件加载失败。
- 如果模型下拉框为空，优先检查模型类型和放置目录。
- 如果开始生成后失败，优先看显存、模型版本和具体报错节点。
- 如果更新后才坏，优先考虑插件版本不兼容，必要时回退或临时移除插件。
常见错误
- 把节点当成固定界面，不敢移动和修改。
- 只复制别人的工作流，不看缺哪些模型。
- 端口类型不匹配还强行连接。
验证是否成功
- 你能说出 Load Checkpoint 到 Save Image 的每一步作用。
- 删除无关预览节点后，主流程仍能生成图片。
如果仍然失败
请把控制台里从 Traceback 开始到最后一行的完整报错保存下来，同时记录：ComfyUI 版本、启动方式、显卡型号、显存容量、使用的模型文件名、刚安装过哪些插件。不要只截网页上的红色提示，因为真正有用的信息通常在启动窗口里。
如果你在本站提交反馈，登录状态下会自动附带 user_id，方便后续追踪同一个用户遇到的连续问题；未登录也可以匿名提交。
下一步推荐
- 新手路线：/topics/comfyui-beginner/
- 报错排查：/topics/comfyui-errors/
- 模型基础：/topics/model-basics/
- 插件安装：/topics/must-have-plugins/
更新记录
- 2026-05-12：扩写为正式教程，补充操作步骤、常见错误和验证清单。