跳至正文
ComfyUI WorldBETA
登录
独立的 COMFYUI 知识站

少一点寻找,多一点创作。

粘贴报错,找到对应的解决方法;或者从工作流出发,弄清背后的模型文件与节点。

报错日志会交给「报错查询」处理(不保存、不写入网址);其他内容会直接搜索。

公开阅读 · 来源清晰 · 账号收藏
原创工作流插画:节点将模型文件和控制项连接到一幅湖景图像
AI 辅助原创概念插画 · 非 ComfyUI 截图或推理结果
COMFYUI 动态

ComfyUI 最新动态

ComfyUI 项目的版本发布、官方公告与节点注册表变化。

查看全部动态
  1. 前端版本
    ComfyUI Frontend v1.53.8(在新标签页打开)
  2. 核心版本
    ComfyUI v0.37.4(在新标签页打开)
  3. 核心版本
    ComfyUI v0.37.3(在新标签页打开)
  4. 核心版本
    ComfyUI v0.37.2(在新标签页打开)
  5. 官方博客
    Introducing Comfy Router: One API for Frontier Media Models(在新标签页打开)
  6. 核心版本
    ComfyUI v0.37.1(在新标签页打开)
从这里开始

新手最常遇到的问题

刚开始使用 ComfyUI 时最常卡住的地方,以及怎么解决。

全部问题排查
教程约 3 分钟阅读
ComfyUI 界面入门:认识画布、节点与执行队列

先认识 ComfyUI 的节点画布、工作流图、模型与节点面板、执行队列和输出。不同版本的标签与布局可能变化;本指南依据当前官方界面文档,不代表本站实机测试。

教程约 2 分钟阅读
导入别人工作流前,先做这份依赖检查

收到 JSON、图片或视频示例时,先识别格式和出处,再核对节点、模型与环境。这份检查清单用于降低盲目安装成本,但静态读取并不能替代在目标环境执行。

问题排查约 2 分钟阅读
Value not in list:模型已经下载,为什么下拉框仍找不到

日志关键词: Value not in list

运行时 ckpt_name、lora_name 或其他下拉参数不在当前选项中。通常需要检查扫描目录、文件名、正在运行的实例和下拉框旧值,但这个错误也可发生在采样器等非文件选项上。

问题排查约 3 分钟阅读
CUDA out of memory:按加载、采样和解码阶段排查显存

日志关键词: CUDA out of memory

任务在 GPU 上分配内存失败。先定位失败发生在模型加载、采样、VAE 解码还是其他节点,再决定降低哪个负载。显卡标称容量、模型文件体积和本次实际可用显存不是同一个数字。

问题排查约 2 分钟阅读
ModuleNotFoundError:包已安装,ComfyUI 仍说找不到模块

日志关键词: 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 启动器资料卡:平台支持,以及让它改动环境前的注意事项。

模型

模型家族

每个模型需要哪些文件、放在哪里,以及可以先跑的第一个工作流。

全部模型
教程

按技巧学习

先掌握基础图像技巧,再进入显存、排错与 API 集成。

全部教程
  1. 01
    图生图的 denoise 怎么理解:从输入图到 latent 的流程

    适用于基于官方基础图生图示例理解输入图像如何影响结果。此文区分图生图的输入路径、denoise 与随机种子,不把某个固定数值包装成适用于所有图像的最佳参数。

  2. 02
    局部重绘:遮罩、原图与 VAE 编码要怎样对应

    局部重绘是在选定区域重新生成内容。使用官方基础 inpainting 示例时,需要同时理解图像、遮罩与适配模型,不应把“画出一个白色区域”当作整套依赖已经正确。

  3. 03
    扩图与放大有什么区别:画布变大还是像素变多

    想让图更大,可能是在原画面之外生成新内容,也可能只是提高现有画面的像素分辨率。两者目标、节点与风险不同,选错工作流会造成看似尺寸正确但内容不符合预期。

  4. 04
    ControlNet 入门:先看控制图,再看生成结果

    将轮廓、姿态或深度信息加入生成流程时,首先应确认控制图是什么、ControlNet 需要什么,以及控制条件是否进入实际采样链路。此文不把所有控制模型归成一个万能节点。

  5. 05
    LoRA 从下载到生效:文件、模型分支和文本分支检查

    这是一份从原生工作流加入单个 LoRA 的操作指南。先建立明确的底模兼容性和对照,再探索强度及组合,不以“下拉框能选”代替真正生效。

  6. 06
    安装自定义节点的完整检查清单:代码、依赖、注册三步分开

    从工作流里发现一个缺失节点后,需要确定它来自哪个项目、安装代码和依赖,并检查服务端注册。下载仓库成功只是其中一步,不应直接当成节点已经可用。

在线工具

在浏览器里就能用的工具

排查、检查与接入,都不需要安装任何东西。

知识库

从这里进入知识库

按你现在要做的事,选择一个栏目。

常见问题

新手常见问题

简短回答,每条都附有完整文章。

打开 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 环境、已安装节点和工作流版本。

阅读完整文章
你的第一个工作流

第一次使用,从这里开始

导入工作流,理解文件与节点,再把它们连接起来。

开始学习
  1. 01模型与工作流
  2. 02依赖与报错
  3. 03界面与接口