先认识 ComfyUI 的节点画布、工作流图、模型与节点面板、执行队列和输出。不同版本的标签与布局可能变化;本指南依据当前官方界面文档,不代表本站实机测试。
少一点寻找,多一点创作。
粘贴报错,找到对应的解决方法;或者从工作流出发,弄清背后的模型文件与节点。
报错日志会交给「报错查询」处理(不保存、不写入网址);其他内容会直接搜索。

ComfyUI 最新动态
ComfyUI 项目的版本发布、官方公告与节点注册表变化。
新手最常遇到的问题
刚开始使用 ComfyUI 时最常卡住的地方,以及怎么解决。
收到 JSON、图片或视频示例时,先识别格式和出处,再核对节点、模型与环境。这份检查清单用于降低盲目安装成本,但静态读取并不能替代在目标环境执行。
日志关键词: Missing Node Types
适用于导入他人工作流后出现红色缺失节点、运行时找不到节点类型的情况。先保存工作流副本和原始下载地址;不要把“缺失节点”自动理解成电脑里完全没有相关文件。
日志关键词: Value not in list
运行时 ckpt_name、lora_name 或其他下拉参数不在当前选项中。通常需要检查扫描目录、文件名、正在运行的实例和下拉框旧值,但这个错误也可发生在采样器等非文件选项上。
日志关键词: CUDA out of memory
任务在 GPU 上分配内存失败。先定位失败发生在模型加载、采样、VAE 解码还是其他节点,再决定降低哪个负载。显卡标称容量、模型文件体积和本次实际可用显存不是同一个数字。
日志关键词: ModuleNotFoundError
适用于启动或执行自定义节点时提示缺少 Python 模块。命令行显示“已安装”仍可能是另一个 Python 的结果;Windows Portable 尤其需要区分系统 Python 与内置解释器。
先选好 ComfyUI 的运行方式
不同安装方式管理 Python 的方法不同。先确定你用哪一种,再看对应指南。
- Windows
- macOS
- Linux
官方 Comfy Desktop
在受支持的 Windows、Apple 芯片 Mac 或 Linux 系统上使用官方应用;先核对对应平台的要求。
- macOS
macOS 安装
选择桌面版或独立的手动 Python 环境,并为 Mac 匹配 PyTorch。
- 浏览器
- 远程 GPU
云端或远程 GPU
区分官方 Comfy Cloud、自建 GPU、容器和笔记本环境。
- Windows
Windows 便携版(Portable)
自带 Python 与 ComfyUI 目录。安装任何依赖前,先弄清它实际使用的是哪个 Python。
- Windows
- Linux
- macOS
手动安装(git + 虚拟环境)
先确定受支持的 Python、设备后端和独立工作目录,而不是给所有机器同一条 pip 命令。
- Windows
第三方启动器
独立整理的 Windows 启动器资料卡:平台支持,以及让它改动环境前的注意事项。
模型家族
每个模型需要哪些文件、放在哪里,以及可以先跑的第一个工作流。
Stable Diffusion 1.5
- 文生图
- 入门工作流
按技巧学习
先掌握基础图像技巧,再进入显存、排错与 API 集成。
- 01图生图的 denoise 怎么理解:从输入图到 latent 的流程
适用于基于官方基础图生图示例理解输入图像如何影响结果。此文区分图生图的输入路径、denoise 与随机种子,不把某个固定数值包装成适用于所有图像的最佳参数。
- 02局部重绘:遮罩、原图与 VAE 编码要怎样对应
局部重绘是在选定区域重新生成内容。使用官方基础 inpainting 示例时,需要同时理解图像、遮罩与适配模型,不应把“画出一个白色区域”当作整套依赖已经正确。
- 03扩图与放大有什么区别:画布变大还是像素变多
想让图更大,可能是在原画面之外生成新内容,也可能只是提高现有画面的像素分辨率。两者目标、节点与风险不同,选错工作流会造成看似尺寸正确但内容不符合预期。
- 04ControlNet 入门:先看控制图,再看生成结果
将轮廓、姿态或深度信息加入生成流程时,首先应确认控制图是什么、ControlNet 需要什么,以及控制条件是否进入实际采样链路。此文不把所有控制模型归成一个万能节点。
- 05LoRA 从下载到生效:文件、模型分支和文本分支检查
这是一份从原生工作流加入单个 LoRA 的操作指南。先建立明确的底模兼容性和对照,再探索强度及组合,不以“下拉框能选”代替真正生效。
- 06安装自定义节点的完整检查清单:代码、依赖、注册三步分开
从工作流里发现一个缺失节点后,需要确定它来自哪个项目、安装代码和依赖,并检查服务端注册。下载仓库成功只是其中一步,不应直接当成节点已经可用。
- 01低内存工作流怎么调整:一次只改变一个负载因素
本页整理没有额外硬件时如何建立可比较的小任务基线。目标是找到某个具体环境的可运行范围,而不是从模型名字推测一个对所有人有效的最低显存数字。
- 02如何用最小环境和二分法定位自定义节点冲突
当不知道哪一个扩展造成报错、白屏或更新故障时,用可复核的分组对照替代随机卸载。目标是定位最小触发集合,而不是把所有第三方节点都判定有问题。
- 03把工作流接入原生 API:从正确导出到取得 prompt_id
本指南面向调用自有或获授权 ComfyUI 实例的开发者。网站提供的 MCP 与 ComfyUI 原生 HTTP API 是两套不同接口;这里讨论后者,不涉及自动登录第三方平台或绕过访问限制。
- 04API 结果怎么取回:从任务历史到实际图片文件
工作流执行成功后,调用方还需要知道哪些节点产生了结果、结果保存在什么位置,以及如何取回。不要把节点 ID、文件名和任务 ID 混成一个字段。
- 05把 ComfyUI 接入自己的应用:优先划清服务接口,不直接塞进 main.py
用独立服务、任务标识与结果接口设计集成,区分 Python 入口脚本和稳定 API 契约。
- 06有两张显卡却只用一张:选卡、多任务和显存合并是三件事
先核对进程可见的设备和实际后端,不把 GPU 0 标签当成物理显卡身份,也不默认显存相加。
在浏览器里就能用的工具
排查、检查与接入,都不需要安装任何东西。
从这里进入知识库
按你现在要做的事,选择一个栏目。
新手常见问题
简短回答,每条都附有完整文章。
打开 ComfyUI 后,界面上都是什么?
节点画布承载工作流图,另有模型与节点面板、执行队列和输出结果。不同版本的标签与布局可能不同。
阅读完整文章包已经装了,ComfyUI 还是提示 “No module named …”,为什么?
命令行显示“已安装”,不代表 ComfyUI 用的是同一个 Python。先分清导入名、包名和正在运行的解释器;Windows Portable 尤其要区分系统 Python 与内置解释器。
阅读完整文章遇到 “CUDA out of memory” 该怎么办?
先定位失败发生在模型加载、采样还是 VAE 解码,再降低对应的负载。显卡标称容量、模型文件体积和本次实际可用显存不是同一个数字。
阅读完整文章模型已经下载了,为什么下拉框里找不到?
检查扫描目录、文件名、正在运行的实例和下拉框里的旧值。“Value not in list” 也可能发生在采样器等非文件选项上。
阅读完整文章导入别人的工作流后出现红色缺失节点,怎么办?
先保存工作流副本,再区分未安装、未注册和加载失败三种情况。缺失节点不等于电脑里完全没有相关文件。
阅读完整文章为什么连不上 127.0.0.1:8188?
localhost 指的是发起访问的那台设备。先确认 ComfyUI 实际运行在本机、容器、Notebook 还是远程服务器,再使用对应地址。
阅读完整文章出现 “Torch not compiled with CUDA enabled”,要重装显卡驱动吗?
不要先重装驱动。它可能是装了仅 CPU 的 PyTorch,也可能是在 Mac 等非 NVIDIA 设备上用了 CUDA 专属节点,修复方向完全不同。
阅读完整文章多个 ComfyUI 能共用一个模型目录吗?
可以,通过受支持的 extra_model_paths 配置引用已有目录。但共享的只是文件,不包括 Python 环境、已安装节点和工作流版本。
阅读完整文章