ComfyUI在Windows上怎么装

AI技术
小华
2025-12-05

Windows 安装 ComfyUI 的简明步骤
一 安装方式与准备

  • 方式一 独立整合包(推荐,解压即用)
  • 适合新手与不想手动配环境的用户。到 GitHub Releases 下载带有 ComfyUI_windows_portable_nvidia_cu121_or_cpu.7z 字样的包,解压到路径短且无中文的位置(如 D:ComfyUI)。整合包通常已自带 Python 与运行脚本。为后续装插件,建议同时安装 Git
  • 方式二 原生源码安装(可控性高)
  • 准备:Python 3.10–3.12Git、(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.exampleextra_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 会显著变慢。
  • 路径或权限问题
  • 安装路径避免中文与过长路径;以管理员权限运行终端/脚本可规避部分权限报错。
亿速云提供售前/售后服务

售前业务咨询

售后技术保障

400-100-2938

7*24小时售后电话

官方微信小程序