【新手教程】ComfyUI 零基础安装指南：从零搭建AI图像生成工作流

显示全部楼层

【新手教程】ComfyUI 零基础安装指南：从零搭建AI图像生成工作流

最近GitHub上AI图像生成工具持续火爆，ComfyUI作为最灵活的可视化工作流工具，已经成为AI绘画进阶玩家的标配。但很多新手被复杂的节点操作劝退。今天这篇教程，手把手带你从零安装到出图，全程无坑。

------

一、什么是ComfyUI？为什么值得学？

ComfyUI是一个基于节点的Stable Diffusion图形化界面，跟WebUI相比有三大优势：

极致灵活：节点式工作流，可以搭建任意复杂的图像生成流程
显存友好：内存管理优化更好，同等配置可以跑更大的模型
生态丰富： thousands of自定义节点，从ControlNet到视频生成应有尽有

如果你已经会用WebUI出图，但想进阶控制生成流程，ComfyUI是必经之路。

------

二、前置条件检查

在开始安装前，请确认你的环境满足以下要求：

操作系统：Windows 10/11、macOS（Apple Silicon/Intel）、Linux均可
显卡：NVIDIA显卡推荐（显存8G以上体验较好），AMD和Apple Silicon也支持
硬盘空间：至少预留20GB（模型文件较大）
网络：能访问GitHub和HuggingFace（模型下载需要）

注意：如果你只有CPU没有独立显卡，也可以运行，但生成速度会非常慢，不推荐。

------

三、安装步骤

步骤1：安装Git和Python

ComfyUI需要Git和Python 3.10+环境。

Git下载：https://git-scm.com/downloads
Python下载：https://www.python.org/downloads/（建议3.10或3.11）

安装Python时，务必勾选"Add Python to PATH"。

步骤2：克隆ComfyUI仓库

打开终端（Windows用CMD或PowerShell），执行：

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

复制代码

步骤3：创建虚拟环境并安装依赖

python -m venv venv
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt

复制代码

说明：cu121对应CUDA 12.1，如果你的显卡驱动较老，可以尝试cu118。Apple Silicon用户不需要CUDA，直接pip install torch即可。

步骤4：下载基础模型

ComfyUI需要至少一个Checkpoint模型才能运行。推荐新手先下载SDXL基础模型：

创建目录：
1. mkdir -p models/checkpoints
复制代码
下载模型：从HuggingFace下载SDXL基础模型，放入models/checkpoints目录

步骤5：启动ComfyUI

python main.py

复制代码

看到终端显示"To see the GUI go to: http://127.0.0.1:8188"就表示启动成功了。

打开浏览器访问 http://127.0.0.1:8188，就能看到ComfyUI的界面了。

------

四、验证安装：跑通第一个工作流

首次打开界面是空白的，我们需要加载一个基础工作流：

点击右侧菜单的"Load"按钮
选择ComfyUI目录下的
1. workflow_examples/basic.json
复制代码
点击"Queue Prompt"按钮
等待片刻，右侧就会生成第一张图片

如果成功出图，恭喜你，ComfyUI安装完成！

------

五、常见问题与解决

Q1：启动时报错"No module named 'torch'"
A：虚拟环境没有激活，或者pip安装到了系统环境。确认venv已激活，重新执行pip install。

Q2：CUDA out of memory
A：显存不足。可以尝试：

降低图片分辨率（默认可能是1024x1024，改成512x512）
关闭其他占用显存的程序
使用--lowvram或--normalvram启动参数

Q3：模型下载太慢或失败
A：HuggingFace国内访问不稳定，可以：

使用镜像站如hf-mirror.com
用迅雷等工具下载后手动放入models目录

Q4：macOS上生成速度极慢
A：Apple Silicon使用MPS后端，首次运行需要编译缓存，后续会快一些。也可以尝试使用--force-fp16参数。

Q5：界面全是英文看不懂
A：ComfyUI社区有中文翻译插件AIGODLIKE-ComfyUI-Translation，安装后可以在设置中切换中文。

------

六、进阶建议

安装完成后，建议按这个顺序进阶：