ComfyUI 是一款专为 AI 绘画与图像生成设计的图形化工作流工具，广泛用于基于 Stable Diffusion 模型的图像生成任务。它通过节点式（Node-based）界面让用户以可视化方式连接不同的处理模块（如文本编码器、VAE、UNet、采样器等），从而构建高度可定制的图像生成流程。相比传统的“一键生成”式界面（如 Automatic1111 的 WebUI），ComfyUI 更适合高级用户进行精细化控制和实验性创作。

其核心优势包括：

• 模块化设计：每个功能（如提示词处理、潜变量生成、去噪步骤、图像解码）都作为一个独立节点存在，用户可自由组合。
• 高效资源利用：支持显存优化，可在较低配置的 GPU 上运行复杂模型。
• 可复现性与分享：整个工作流可以保存为 JSON 文件，方便分享与重复使用。
• 扩展性强：支持大量自定义节点插件（如 ControlNet、LoRA、IP-Adapter 等），实现姿态控制、风格迁移、图像修复等功能。

使用 ComfyUI 的典型工作流包括以下节点链路：

1. 输入正向/反向提示词 → 文本编码节点
2. 设置采样参数（采样器、步数、CFG 值）→ 采样节点
3. 加载基础模型（如 SDXL 或 SD 1.5）→ 模型加载节点
4. 结合潜在空间随机噪声 → UNet 去噪
5. VAE 解码生成最终图像

# 示例：ComfyUI 工作流逻辑示意（非实际运行代码）
workflow = {
    "prompt": "a beautiful landscape with mountains and sunset",
    "negative_prompt": "blurry, low quality",
    "steps": 20,
    "cfg": 7.5,
    "sampler": "euler_ancestral",
    "model": "stabilityai/stable-diffusion-xl-base-1.0",
    "vae": "auto",
    "seed": 123456
}
# 实际操作在图形界面中通过拖拽节点完成

安装和配置 ComfyUI 的本地运行环境可以通过以下步骤完成，适用于 Windows、Linux 和 macOS 系统。ComfyUI 基于 Python 构建，并依赖 Git 和 PyTorch 来运行 Stable Diffusion 模型。

一、系统要求

• 操作系统：Windows 10/11、Linux（如 Ubuntu）、macOS（M1/M2 推荐）
• GPU 支持：NVIDIA（CUDA）、AMD（ROCm）或 Apple Silicon（M系列芯片）
• 内存：至少 8GB RAM，推荐 16GB+
• 显存：至少 4GB VRAM，推荐 8GB+ 以支持 SDXL 等大模型

---

二、安装步骤

1. 安装 Python 和 Git

• 下载并安装 Python 3.10（建议使用 3.10.x 版本，兼容性最佳）
• 下载并安装 Git

验证安装：

python --version
git --version

2. 克隆 ComfyUI 仓库

打开终端（或命令提示符），执行：

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

3. 安装 Python 依赖

pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu118
pip install -r requirements.txt

注：若使用 CPU 运行（无 GPU），可安装 CPU 版 PyTorch（速度较慢）：

pip install torch torchvision torchaudio

4. 下载模型文件

将 Stable Diffusion 模型放入 ComfyUI/models/checkpoints/ 目录中，例如：

• v1-5-pruned.ckpt（SD 1.5）
• sd_xl_base_1.0.safetensors（SDXL）

可从 Hugging Face 或 Civitai 下载合法授权的模型。

5. 启动 ComfyUI

在项目根目录运行：

python main.py

启动后，默认访问地址为：http://127.0.0.1:8188

---

三、常见配置选项

启动时可添加参数优化性能：

python main.py --listen 0.0.0.0 --port 8188 --gpu-only --dont-upcast-attention

常用参数说明：

• --listen：允许局域网访问
• --gpu-only：强制使用 GPU
• --safe-unpickle：提高安全性（禁用自定义脚本）
• --disable-metadata：减少保存图像的元数据

---

四、首次使用建议

1. 打开浏览器进入界面 → 拖拽“Load Checkpoint”节点加载模型。
2. 连接提示词、采样器、VAE 和图像生成节点。
3. 右键点击“KSampler”节点选择“Queue Prompt”开始生成。

ComfyUI 启动失败是初学者常见的问题，可能由环境配置、依赖缺失或硬件兼容性引起。以下是常见原因及其解决方案：

---

1. Python 或 PyTorch 版本不兼容

• 表现：报错 ModuleNotFoundError、No module named 'torch'
• 原因：未安装 PyTorch 或版本错误
• ✅ 解决方法：
  • 确保安装的是 Python 3.10（推荐）
  • 安装对应版本的 PyTorch：

    # NVIDIA GPU（CUDA 11.8）
    pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu118
    
    # Apple M系列芯片（Metal 加速）
    pip install torch torchvision torchaudio
    
    # CPU-only（无GPU）
    pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
    

---

2. 缺少依赖包（requirements.txt 未正确安装）

• 表现：启动时报 ImportError: No module named 'folder_paths' 或类似错误
• ✅ 解决方法：
  在 ComfyUI 根目录运行：

  pip install -r requirements.txt
  

  若网络慢，可使用国内镜像源：

  pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
  

---

3. 模型文件缺失或路径错误

• 表现：启动后无法加载模型，提示 Checkpoint not found
• ✅ 解决方法：
  将 .ckpt 或 .safetensors 模型文件放入：

  ComfyUI/models/checkpoints/
  

  推荐测试模型：
  • v1-5-pruned.ckpt
  • sd_xl_base_1.0.safetensors

---

4. 显存不足（Out of Memory, OOM）

• 表现：程序崩溃、黑屏退出、报错 CUDA out of memory
• ✅ 解决方法：
  • 添加低显存优化参数启动：

    python main.py --gpu-only --disable-xformers --lowvram
    

  • 使用 --force-fp16 强制半精度减少内存占用
  • 避免同时运行其他大型 AI 工具（如 WebUI）

---

5. 端口被占用

• 表现：提示 Address already in use 或无法访问 8188
• ✅ 解决方法：
  更换端口启动：

  python main.py --port 8189
  

  或终止占用进程（Windows）：

  netstat -ano | findstr :8188
  taskkill /PID <进程号> /F
  

---

6. Git 克隆不完整或子模块缺失

• 表现：界面空白、节点加载失败
• ✅ 解决方法：
  确保完整克隆项目：

  git clone --recurse-submodules https://github.com/comfyanonymous/ComfyUI.git
  

  若已克隆，更新子模块：

  git submodule update --init --recursive
  

---

7. 防病毒软件或系统权限阻止运行

• 表现：双击无反应、脚本被拦截
• ✅ 解决方法：
  • 将 ComfyUI 文件夹添加到杀毒软件白名单
  • 以管理员身份运行终端
  • 在 Windows 上关闭 SmartScreen

---

8. 自定义节点导致冲突

• 表现：启动卡住、报错指向某个节点
• ✅ 解决方法：
  • 临时重命名 custom_nodes 文件夹以禁用所有插件
  • 逐个启用排查问题节点
  • 更新节点至最新版本

---

快速诊断建议

1. 查看命令行输出日志定位具体错误
2. 使用最小配置测试：仅保留基础模型和默认节点
3. 参考官方 GitHub Issues：https://github.com/comfyanonymous/ComfyUI/issues