零基础玩转ComfyUI：从安装到进阶的避坑指南

副标题：面向AI绘画爱好者的ComfyUI全流程配置手册，教你用最强大的节点式界面轻松构建稳定扩散工作流

准备工作：启动前的环境检查

硬件兼容性自查

💡 我建议先确认你的设备是否满足基本要求：

• GPU：推荐NVIDIA显卡（显存≥4GB），AMD或CPU也可运行但速度较慢
• 内存：至少8GB RAM（16GB以上体验更佳）
• 存储空间：预留20GB以上（含模型文件）

必备软件安装

1. 安装Python 3.8+（编程语言，用于运行ComfyUI后端）
   • 💡 建议使用3.10版本，兼容性最佳
2. 安装Git（版本控制工具，用于获取项目代码）
3. （Windows用户）安装7-Zip（用于解压压缩包）

系统适配：三大平台的安装实战

Linux系统安装步骤

1. 获取项目代码

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

   💡 这行命令会将项目下载到当前目录并进入项目文件夹

2. 创建虚拟环境（可选但推荐）

   python -m venv venv
   source venv/bin/activate
   

3. 安装依赖包

   pip install -r requirements.txt
   

   ⚠️ 如果出现PyTorch相关错误，请访问PyTorch官网获取对应系统的安装命令

4. 准备模型文件

   • 将下载的Stable Diffusion模型（.ckpt或.safetensors格式）复制到models/checkpoints目录
   • 💡 首次使用可先下载SDXL基础模型，体积适中且效果好

5. 启动应用

   python main.py
   

Windows系统安装步骤

1. 下载项目压缩包并解压

   • 💡 推荐使用7-Zip右键解压，避免中文路径

2. 安装依赖

   • 双击install_dependencies.bat文件自动安装所需包

3. 放置模型文件

   • 将模型文件复制到models\checkpoints文件夹

4. 启动程序

   • 双击run_nvidia_gpu.bat（NVIDIA用户）
   • 或run_cpu.bat（无GPU用户）

macOS系统安装要点

1. 安装PyTorch

   pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cpu
   

2. 后续步骤同Linux系统 ⚠️ M1/M2芯片用户需使用Rosetta2转译运行

配置优化：让ComfyUI更好用

模型路径配置

1. 复制配置文件模板

   cp extra_model_paths.yaml.example extra_model_paths.yaml
   

2. 编辑配置文件

   • 使用文本编辑器打开extra_model_paths.yaml
   • 添加自定义模型路径，格式如下：

   comfyui:
     checkpoints: ["/path/to/your/models"]
   

   💡 这样可以让ComfyUI识别非默认路径的模型文件

界面个性化设置

1. 启动后访问 http://127.0.0.1:8188
2. 在设置面板中调整：
   • 主题颜色（深色/浅色）
   • 节点默认大小
   • 自动保存频率

验证安装：确认一切正常

基础功能测试

1. 启动ComfyUI后，在浏览器中打开界面
2. 加载默认工作流（左上角"Load"按钮）
3. 点击"Queue Prompt"按钮运行
4. 预期结果：在output目录生成示例图像，类似下图：

ComfyUI默认工作流生成的示例图像

节点系统验证

查看节点编辑界面是否正常显示各类参数选项：

ComfyUI节点编辑器中的输入选项面板

常见问题速查表

问题现象	Windows解决方法	Linux解决方法	macOS解决方法
启动时报错"缺少torch"	重新运行install_dependencies.bat	执行pip install torch	安装PyTorch nightly版
模型无法加载	检查models/checkpoints路径	确认文件权限chmod 644 *.safetensors	检查文件是否完整
界面无响应	关闭防火墙重试	检查8188端口是否被占用	重启终端并重试
生成速度慢	切换到GPU模式	安装CUDA工具包	使用--force-cpu参数

拓展应用：从入门到进阶

推荐首批安装的扩展

1. 自定义节点市场：custom_nodes目录放置社区节点
2. 模型管理工具：安装ComfyUI-Manager扩展

   cd custom_nodes
   git clone https://gitcode.com/.../ComfyUI-Manager
   

性能优化技巧

• 使用TAESD模型加速预览：将taesd_encoder.pth放入models/vae_approx
• 启用模型量化：修改comfyui_version.py中的量化参数
• 设置显存优化：在启动命令后添加--lowvram参数

⚠️ 注意：高级优化可能影响生成质量，请先备份配置文件

通过以上步骤，你已经掌握了ComfyUI的基本安装配置方法。接下来可以尝试搭建自己的第一个图像生成工作流，探索节点组合的无限可能！