ComfyUI Windows 安装教程：NVIDIA 显卡本地部署完整步骤
从下载 ComfyUI_windows_portable 到首次启动 WebUI，适合第一次接触 ComfyUI 的 Windows 用户。
你会得到什么
照着本文做完，你应该能：
- 确认 NVIDIA 驱动可用。
- 下载正确的 Windows Portable NVIDIA 安装包，避免下载错包。
- 解压到稳定目录，并知道哪些文件不能丢。
- 双击
run_nvidia_gpu.bat启动 ComfyUI。 - 放入第一个 Checkpoint，并进入第一次出图教程。
一句话结论
Windows 新手优先使用 ComfyUI 官方 Windows Portable 包：下载 .7z，解压到短英文路径，双击 run_nvidia_gpu.bat，浏览器打开 http://127.0.0.1:8188，再把 Checkpoint 放到 ComfyUI\models\checkpoints。
这条流程不要跳步。下载错 Source code、只复制 ComfyUI 子目录、把模型放错目录，是 Windows 新手最常见的三个入口卡点。
适合谁
- Windows 10/11 用户。
- NVIDIA 显卡用户，显存 4GB 起步，8GB 以上更舒服。
- 不想手动配置 Python、venv、PyTorch 的用户。
不适合谁
- AMD/Intel 显卡用户：需要 DirectML、ROCm 或 CPU 方案，本文不覆盖。
- 想部署 Linux 服务器的用户：请看 Linux 安装教程。
- 已经有复杂 Python 环境并希望手动维护依赖的用户：可以参考 Linux 教程里的 venv 思路。
上图是小白最容易找错的位置：外层目录里要同时看到 ComfyUI、python_embeded 和 run_nvidia_gpu.bat。真正要双击的是 run_nvidia_gpu.bat，启动成功后再去浏览器打开 127.0.0.1:8188。
开始前检查
开始安装前先确认：Windows 10/11、NVIDIA 显卡、驱动可用、能解压 .7z、准备短英文路径。下面每一步都是为了减少新手入口错误，不建议跳过。
第 1 步：确认显卡和驱动
这是入口检查，不要跳。驱动没装好，后面重装 ComfyUI 也没用。
按 Win + R，输入 cmd，执行：
nvidia-smi如果正常，会看到显卡名称、驱动版本、CUDA Version 和显存占用。
如果提示：
'nvidia-smi' 不是内部或外部命令先去 NVIDIA 官网安装驱动。安装后重启电脑，再重新打开 cmd 执行 nvidia-smi。
注意：这里看到的 CUDA Version 是驱动支持能力，不代表你必须单独安装 CUDA Toolkit。Windows Portable 版已经带好运行所需的 Python/PyTorch。
第 2 步：下载正确的安装包
不想自己找链接，可以先打开本站整理好的 ComfyUI 新手下载入口，里面放了 NVIDIA 驱动、7-Zip、ComfyUI Portable、Git、模型站和 Manager 的官方入口。
直接下载 ComfyUI 时，去 ComfyUI 官方 GitHub Releases 下载 Windows Portable NVIDIA 包。文件名通常类似：
ComfyUI_windows_portable_nvidia.7z不要下载：
Source code.zipSource code.tar.gz- 来路不明的网盘二次打包版
下载错包的表现很明显：解压后没有 python_embeded、没有 run_nvidia_gpu.bat，只有一堆源码文件。新手不要拿源码包继续折腾 Python，直接回 Releases 重新下载 Windows Portable NVIDIA 包。
源码包不是便携安装包，里面没有 python_embeded 和启动脚本，新手下载错会直接卡住。
第 3 步：解压到短英文路径
推荐路径：
D:\AI\ComfyUI_windows_portable也可以：
E:\ComfyUI不推荐：
C:\Users\张三\Desktop\新建文件夹\ComfyUI_windows_portable
C:\Users\用户名\Downloads\ComfyUI windows portable原因：部分 Python 包、自定义节点、bat 脚本对中文、空格、超长路径兼容不好。不是一定会坏，但出错后很难排查。
解压后目录应该类似：
ComfyUI_windows_portable\
ComfyUI\
python_embeded\
run_nvidia_gpu.bat
run_cpu.bat如果没有 python_embeded，说明你下载的不是便携版。
第 4 步：第一次启动
双击：
run_nvidia_gpu.bat不要关闭弹出的黑色控制台窗口。它就是 ComfyUI 后端。浏览器页面只是前端界面。
看到这行说明启动成功：
To see the GUI go to: http://127.0.0.1:8188然后打开浏览器访问：
http://127.0.0.1:8188
这是一张教程标注图。新手先不用管所有菜单，先记住：中间是节点画布，右侧有 Queue Prompt，生成时主要看节点有没有动、控制台有没有红色报错。
如果浏览器打不开，先看黑色窗口有没有报错或已经闪退。
第 5 步：如果 bat 闪退，先让它停住
右键 run_nvidia_gpu.bat，选择“编辑”，在最后加一行：
pause保存后重新双击。这样出错时窗口不会立刻关闭，你可以看到真实报错。
常见报错对应处理：
| 报错关键词 | 处理方向 |
|---|---|
CUDA out of memory | 降分辨率、batch 改 1、换 SD1.5 |
No module named | 依赖缺失，通常是插件问题 |
Torch not compiled with CUDA | PyTorch 环境异常，便携版建议重新解压 |
Address already in use | 8188 端口被占用 |
Load Checkpoint 下拉为空 | 没有放模型或路径错 |
第 6 步：放第一个 Checkpoint
ComfyUI 默认不自带大模型。你至少需要一个 Checkpoint。
放置目录：
ComfyUI_windows_portable\ComfyUI\models\checkpoints\示例：
D:\AI\ComfyUI_windows_portable\ComfyUI\models\checkpoints\v1-5-pruned-emaonly.safetensors放好后有两种刷新方式：
- 在网页中点击 Refresh。
- 关闭并重新运行
run_nvidia_gpu.bat。
如果 Load Checkpoint 还是看不到模型，检查：
- 文件是不是
.safetensors或.ckpt。 - 是否放到了
models\checkpoints，不是models\checkpoint。 - 文件是否只有几 KB；几 KB 通常是网页或下载失败文件，不是模型。
第 7 步：生成第一张图
打开默认工作流，确认：
- Load Checkpoint 选中了模型。
- Empty Latent Image 设置为
512 x 512。 - batch_size 为
1。 - KSampler steps 可先设
20。 - CFG 可先设
7。
点击：
Queue Prompt输出图片默认在：
ComfyUI_windows_portable\ComfyUI\output\第 8 步：常用目录速查
| 内容 | Windows 路径 |
|---|---|
| 输出图片 | ComfyUI\output\ |
| Checkpoint | ComfyUI\models\checkpoints\ |
| LoRA | ComfyUI\models\loras\ |
| VAE | ComfyUI\models\vae\ |
| ControlNet | ComfyUI\models\controlnet\ |
| 自定义节点 | ComfyUI\custom_nodes\ |
| 输入图片 | ComfyUI\input\ |
Windows 路径不区分大小写，但教程中建议保持官方目录名，避免插件写死路径时出问题。
第 9 步：修改启动参数
右键 run_nvidia_gpu.bat 编辑，可以看到类似命令：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build低显存可以改成：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --normalvram更低显存可以试：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --lowvram端口冲突时改端口：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --port 8190然后访问：
http://127.0.0.1:8190常见错误
1. 双击 bat 没反应或闪退
先加 pause，看完整报错。不要凭感觉重装。
2. 页面打不开
确认黑色窗口还在。如果窗口关闭，说明后端没启动。浏览器刷新没有意义。
3. 生成时报 CUDA out of memory
先做这四件事：
- 分辨率改
512 x 512。 - batch_size 改
1。 - 关掉游戏、视频播放器、其他 AI 软件。
- 用 SD1.5 模型，不要一开始跑 SDXL。
4. Load Checkpoint 没模型
模型路径错。Checkpoint 必须在：
ComfyUI\models\checkpoints\LoRA、VAE、ControlNet 不能放这里混用。
5. 装插件后 ComfyUI 坏了
把刚装的插件目录从 custom_nodes 移到别处，再重启。能启动后再慢慢处理依赖。
验证是否成功
你需要同时满足：
nvidia-smi能看到显卡。run_nvidia_gpu.bat启动后窗口不退出。- 浏览器能打开
127.0.0.1:8188。 - Load Checkpoint 能看到模型。
- Queue Prompt 后
output目录出现图片。
下一步推荐
- 第一次出图：
/guides/first-image-generation/ - 模型路径：
/guides/model-file-paths/ - Manager 安装：
/guides/comfyui-manager-install/ - Linux 安装：
/guides/comfyui-linux-install/