Windows 安装 ComfyUI 的简明步骤
一 安装方式与准备
- 方式一 独立整合包(推荐,解压即用)
- 适合新手与不想手动配环境的用户。到 GitHub Releases 下载带有 ComfyUI_windows_portable_nvidia_cu121_or_cpu.7z 字样的包,解压到路径短且无中文的位置(如 D:ComfyUI)。整合包通常已自带 Python 与运行脚本。为后续装插件,建议同时安装 Git。
- 方式二 原生源码安装(可控性高)
- 准备:Python 3.10–3.12、Git、(NVIDIA 用户)匹配驱动的 CUDA。建议创建虚拟环境,便于隔离依赖。
- 通用准备
- 显卡建议 NVIDIA(支持 CUDA)以显著加速;无独显也可 CPU 运行但速度很慢。
- 系统建议 Windows 10/11 64 位。
二 快速安装步骤
1) 解压到如 D:ComfyUI;确保路径无中文与过深层级。
2) 安装 Git(为后续插件管理)。
3) 安装必备插件管理器:进入 ComfyUIcustom_nodes,在地址栏输入 cmd 回车,执行:
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
4) 启动:双击 run_nvidia_gpu.bat(有 N 卡)或 run_cpu.bat(无 N 卡),首次会自动打开浏览器访问 http://127.0.0.1:8188。
1) 克隆仓库:git clone https://github.com/comfyanonymous/ComfyUI.git && cd ComfyUI
2) 创建并激活虚拟环境:python -m venv venv && venvScriptsactivate
3) 安装 PyTorch(示例为 CUDA 12.4):pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu124
4) 安装依赖:pip install -r requirements.txt
5) 启动:python main.py(浏览器打开 http://127.0.0.1:8188)。
三 模型与目录配置
- 默认模型目录结构(示例):
- 大模型(Checkpoint):ComfyUImodelscheckpoints
- VAE:ComfyUImodelsvae
- LoRA/Embeddings/ControlNet 等:分别放入 modelsloras / modelsembeddings / modelscontrolnet 等对应子目录。
- 共享模型目录(可选,便于多工具共用一份模型)
- 复制 extra_model_paths.yaml.example 为 extra_model_paths.yaml,按示例把 a1111 段指向你的 Stable Diffusion WebUI 模型目录(如 D:SDmodels),保存后重启;如需共享,务必放在固态硬盘并使用 USB 3.0/Type‑C 以免加载过慢。
四 常用启动参数与更新
- 常用参数(加到启动脚本或命令行末尾)
- --listen:允许局域网访问
- --port 8188:指定端口(默认 8188)
- --lowvram:低显存模式,牺牲速度换取稳定性
- 更新
- 独立整合包:运行 updateupdate_comfyui.bat 保持内核与依赖为最新。
- 原生源码:在仓库目录执行 git pull,然后重新安装依赖(如有变更)并重启。
五 常见问题与排错
- 启动黑窗一闪而过或报 “Python 不是内部或外部命令”
- 确认 Python 已安装并勾选 Add Python to PATH;原生安装请在虚拟环境内运行;整合包请直接双击 .bat 脚本。
- 显存不足 OOM
- 启动参数加 --lowvram;减少分辨率/批量;优先使用 safetensors 模型;关闭占用显存的后台程序。
- 插件/工作流缺失节点
- 通过 ComfyUI-Manager 的 “Install Missing Custom Nodes” 一键补齐,或手动将插件放到 custom_nodes 并重启。
- 模型加载很慢
- 共享模型目录请放在 SSD,并使用 USB 3.0/Type‑C 连接;机械硬盘或 USB 2.0 会显著变慢。
- 路径或权限问题
- 安装路径避免中文与过长路径;以管理员权限运行终端/脚本可规避部分权限报错。