ComfyUI：零基础上手扩散模型GUI的安装配置指南

价值定位：为什么选择ComfyUI？

ComfyUI作为最强大且模块化的稳定扩散GUI，通过节点式可视化编程，让用户无需复杂代码即可构建专业级图像生成工作流。无论是AI绘画爱好者还是专业创作者，都能通过其直观的图形界面实现从简单图片生到复杂模型微调的全流程控制。

环境适配：跨平台兼容的系统准备

核心技术栈与环境要求

• 解决什么问题：PyTorch框架提供高效GPU加速计算能力，让扩散模型推理速度提升300%；节点式界面将复杂参数配置转化为可视化连接，降低80%学习成本
• 硬件要求：推荐NVIDIA显卡（显存≥4GB），CPU模式支持但生成速度会降低5-10倍
• 基础软件：
  • Python 3.8+（必选）
  • Git（用于代码获取）
  • 系统依赖：Windows需7-Zip解压工具，Linux需gcc编译环境

环境验证步骤

📌 打开终端执行以下命令检查Python版本：

python --version
# 预期输出：Python 3.8.10 或更高版本

分步实施：5分钟完成部署的通用流程

1. 获取项目代码

📌 克隆仓库（全平台通用）：

git clone https://gitcode.com/GitHub_Trending/co/ComfyUI
cd ComfyUI

2. 安装依赖包

📌 执行安装命令并验证：

pip install -r requirements.txt
# 预期输出：Successfully installed ...（无报错信息）

3. 系统差异补充配置

操作系统	额外步骤	验证方式
Windows	无需额外操作	直接进入下一步
Linux	安装系统依赖： sudo apt install libgl1-mesa-glx	echo $? 输出0表示成功
macOS	安装PyTorch nightly： pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cpu	python -c "import torch; print(torch.__version__)" 显示 nightly 版本

4. 模型文件部署

📌 将 Stable Diffusion 模型文件（.ckpt 或 .safetensors）复制到指定目录：

# 创建模型目录（如不存在）
mkdir -p models/checkpoints
# 复制模型文件到该目录（以实际文件名为准）
cp /path/to/your/model.ckpt models/checkpoints/

5. 启动应用并验证

📌 启动ComfyUI：

python main.py
# 预期输出：
# Serving on http://0.0.0.0:8188
# To see the GUI go to http://127.0.0.1:8188

打开浏览器访问 http://127.0.0.1:8188，能看到节点编辑界面即表示基础部署成功。

进阶配置：释放全功能的避坑指南

模型路径配置

📌 编辑配置文件 extra_model_paths.yaml（需先复制示例文件）：

cp extra_model_paths.yaml.example extra_model_paths.yaml

添加自定义模型路径：

comfyui:
  checkpoints: [./models/checkpoints, /path/to/other/checkpoints]
  vae: [./models/vae]

节点类型配置示例

ComfyUI提供丰富的节点配置选项，通过代码定义输入类型实现参数控制： 图：节点输入选项配置界面，展示了required、default等参数设置方式

生成结果示例

成功配置后，可通过节点连接生成图像，以下是基础示例输出： 图：使用默认参数生成的示例图像，展示基础扩散模型效果

常见问题速查

💡 启动时报错"No module named 'torch'"
解决：重新安装PyTorch，确保版本与系统匹配：pip install torch --upgrade

💡 模型无法加载
解决：检查模型文件路径是否正确，文件名是否包含中文或特殊字符

💡 GPU内存不足
解决：在启动命令中添加参数限制显存使用：python main.py --lowvram

💡 界面无响应
解决：清除浏览器缓存或使用隐私模式访问，确保Python版本≥3.8