Windows 完整安装 ComfyUI 保姆级教程｜3 种方案任选，新手零踩坑

前言

ComfyUI 是基于节点流的 Stable Diffusion 绘图工具，相比 WebUI 占用显存更低、自定义自由度拉满，适合做图生图、视频生成、高清修复、批量出图。Windows 平台目前有 官方便携版（新手首选）、官方桌面版、Git 手动源码版 三种安装方式，本文全覆盖，从硬件准备到报错排查一步到位。

一、前置硬件 & 环境准备

1. 硬件最低要求

• 系统：Win10 20H2 / Win11 64 位
• 显卡（推荐 NVIDIA）：
  • 最低：4G 显存（RTX 1650/3050），仅能小尺寸出图
  • 推荐：8G+ 显存（RTX3060/4060/5060），流畅跑 SDXL、动画工作流
  • AMD 显卡：支持，但兼容性、加速插件少于 N 卡
• 硬盘：必须解压 / 安装到 SSD，模型 + 环境至少预留 15G 空间
• 禁止路径：文件夹名称不能含中文、空格、特殊符号（如 D:/AI绘图/ComfyUI 报错，改用 D:/AI/ComfyUI）

2. 必做前置操作（90% 报错根源）

NVIDIA 用户先更新显卡驱动：

1. 英伟达官网下载 GeForce Experience / 驱动程序
2. 安装最新 WHQL 稳定驱动，重启电脑
3. 按下 Win+R 输入 cmd，执行 nvidia-smi，能正常显示显卡、CUDA 版本即成功

二、方案一：官方便携版 Portable（新手强推，解压即用）

优势

自带嵌入式 Python、CUDA、全部依赖，不污染系统环境；可复制到 U 盘移动使用；更新简单，Windows 用户首选。

安装步骤

1. 下载对应压缩包
   • NVIDIA 通用版：ComfyUI_windows_portable_nvidia.7z
   • 老显卡 / 旧驱动专用：cu126 旧版包
   • AMD 显卡：ComfyUI_windows_portable_amd.7z 官方下载地址可在 ComfyUI GitHub Readme 获取直链，推荐用迅雷分流下载（包体积 7G 左右）。
2. 解压文件 右键 7z 压缩包，提取到纯英文无空格目录，示例：D:\ComfyUI_windows_portable ⚠️ 不要解压到桌面、C 盘、中文文件夹。
3. 放入基础模型（缺一不可，启动空白） 进入目录 ComfyUI/models/checkpoints，下载 SD1.5 / SDXL 大模型（.safetensors 格式）放入此处。 常用模型站点：Civitai、LiblibAI、吐司。 其他模型目录说明：
   • vae：VAE 调色模型
   • loras：LoRA 人物 / 风格模型
   • controlnet：ControlNet 控制骨骼、线稿模型
4. 一键启动 回到根目录，双击 run_nvidia_gpu.bat（AMD 双击对应 amd 启动脚本）。
   • 首次运行：自动下载前端依赖、加载环境，等待 2-5 分钟
   • 出现 To see the GUI go to: http://127.0.0.1:8188 代表启动成功，自动弹出浏览器界面。

便携版更新方法

1. 关闭所有 ComfyUI 窗口
2. 运行根目录 update_comfyui.bat，自动拉取官方最新代码
3. 更新完成后重新双击启动脚本即可

三、方案二：ComfyUI Desktop 官方桌面版（图形化管理）

优势

独立 exe 安装程序，像普通软件一样安装；内置模型一键下载、多实例管理、自动迁移旧便携版数据，可视化管理面板，适合纯小白不想碰批处理文件。

安装步骤

1. 进入官方文档下载 Windows .exe 安装包
2. 双击安装程序，自定义安装路径（建议非 C 盘 SSD）
3. 桌面生成快捷方式，双击打开，点击「Get Started」初始化环境
4. 首次初始化自动下载完整运行环境，等待下载完成
5. 新建绘图实例，自动识别本地模型，缺失节点 / 模型一键在线下载

缺点

会占用 C 盘 5G 左右缓存；版本更新略滞后便携版；多环境隔离性弱于便携绿色包。

四、方案三：Git 手动源码部署（进阶 / 开发者专用）

适合需要自定义 Python、PyTorch 版本、二次开发、批量多环境的用户。

前置软件安装

1. Git for Windows（官网下载，一路默认安装）
2. Python 3.12 稳定版，安装时勾选「Add Python to PATH」

完整命令流程

1. 新建英文目录，右键打开 Git Bash，克隆源码

bash

运行

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

2. 创建独立虚拟环境（隔离系统 Python）

bash

运行

python -m venv venv
venv\Scripts\activate

3. 安装基础依赖（国内镜像加速，避免下载超时）

bash

运行

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

4. 安装 NVIDIA CUDA 版 PyTorch（50 系显卡推荐 cu128）

bash

运行

pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu128

5. 放入模型，启动服务

bash

运行

python main.py

访问 127.0.0.1:8188 进入绘图界面。

更新源码

bash

运行

git pull
pip install -r requirements.txt

五、安装后必备配置：ComfyUI Manager 节点管理器

无论哪种安装方式，必须装这个插件，一键安装自定义节点、修复缺失依赖、导入外部工作流。

1. 进入 ComfyUI/custom_nodes 文件夹
2. Git 克隆插件仓库：

bash

运行

git clone https://github.com/ltdrdata/ComfyUI-Manager.git

3. 重启 ComfyUI，界面侧边栏出现 Manager 按钮，即可在线下载所有第三方节点。

六、高频报错 & 完整解决方案（新手必看）

1. 启动闪退、一闪而过

• 路径含中文 / 空格 → 重新解压到纯英文目录
• 显卡驱动版本过低 → 更新 NVIDIA 驱动
• 杀毒软件拦截批处理 → 把 ComfyUI 文件夹加入白名单

2. Torch not compiled with CUDA enabled 无法调用显卡

• 便携版：不要用系统 Python，必须运行自带 .bat 启动
• 手动部署：卸载现有 torch，重装对应 CUDA 版本 PyTorch
• 验证命令：

bash

运行

python -c "import torch; print(torch.cuda.is_available())"

输出 True 代表 GPU 正常启用。

3. CUDA out of memory 显存溢出

• 降低出图分辨率（768×1024 改 512×768）
• 启动脚本添加低显存参数：python main.py --lowvram
• 关闭浏览器、游戏等占用显存的软件

4. 端口被占用 Address already in use

修改启动端口，手动运行：

bash

运行

python main.py --port 8189

5. 模型加载报错、黑色画面

• 模型损坏，重新下载 .safetensors 文件
• VAE 缺失，放入对应 vae 模型到 vae 文件夹
• 工作流版本不匹配，用 Manager 一键修复缺失节点

七、三种安装方式对比总结

表格

写在最后

ComfyUI 上手门槛在于节点逻辑，安装环节只要避开中文路径、旧驱动、缺少大模型三个坑，基本一次成功。优先选择便携版，搭配 ComfyUI Manager 插件，即可实现从出图、高清修复、动态视频全流程 AI 绘图。如果是 4G 小显存显卡，建议全程开启 --lowvram 参数降低显存占用。