安装：Windows 便携包 5 分钟跑起来

搜「ComfyUI 安装」的你，可能已经被「先装 Python、再装 PyTorch、配 CUDA」的教程吓到过。好消息：ComfyUI Windows 安装有一条完全不碰这些的路——官方便携包（Portable）：一个 7z 压缩包，自带独立 Python 环境和对应显卡的 PyTorch，解压即用。下载完成后的操作，5 分钟足够；下载本身的时间，就看你的网速了。

这节课带你走完 Windows 便携包路线：选对包 → 解压 → 双击启动 → 浏览器看到节点画布。想用桌面版、或你是 Mac / Linux 用户，直接去 备用安装。

学完你能做什么

• 下载与你的显卡匹配的 ComfyUI 官方便携包（NVIDIA / AMD / Intel 各有对应文件）
• 解压 7z 包，并用正确的 .bat 脚本启动 ComfyUI
• 在浏览器打开 http://127.0.0.1:8188，看到节点画布
• 说清「ComfyUI 显卡要求」：哪张卡该下哪个包、没有独显怎么办
• 用 update 文件夹里的官方脚本给便携版升级

你现在的困境

• 想玩 AI 画图，搜「ComfyUI Windows 安装」，出来的教程全是「装 Python → 配 pip 源 → 装 PyTorch → 对 CUDA 版本」，还没开始就劝退
• 以前装过整合包，Python 环境和别的软件打架，卸载都卸不干净
• 下载了 ComfyUI，不知道双击哪个文件；黑窗口一闪而过，或者服务起来了却不知道界面在哪

什么时候用这一招

当你需要：

• 在 Windows 上最快跑起 ComfyUI：不装 Python、不配 CUDA、不动系统环境
• 一个「绿色」的安装：整个程序连同独立 Python 环境都在一个文件夹里
• 直接用官方为你的显卡（NVIDIA / AMD / Intel）预编译好的版本

而且不想：

• 折腾 Python 版本与 PyTorch、CUDA 的匹配关系
• 在系统里留下一堆环境变量和依赖
• 先学会 conda、venv 这些词才能开始画图

💡 官方还有个桌面版

官方同时提供 Comfy Desktop 桌面版，官方 README 称它「对新用户最简单」，带图形安装器、自身会自动更新。便携包与桌面版跑的是同一个 ComfyUI，二选一即可；桌面版的装法见 备用安装。

🎒 开始前的准备

• 读完上一课 ComfyUI 是什么：知道节点、连线、工作流是什么，装完打开界面不发懵
• 一台 Windows 电脑：较新版本的 Windows 资源管理器能直接解压 7z，老系统先装免费的 7-Zip
• 搞清楚自己的显卡品牌（NVIDIA / AMD / Intel）：不确定就去设备管理器的「显示适配器」里看一眼
• 浏览器建议 Google Chrome 143 或更高——官方明确说 142 及以下有已知的显示与性能问题
• 硬盘留足空间：便携包解压后不小，之后每个模型动辄好几个 GB
• 一杯水 ☕

⚠️ 国内下载提示

安装包托管在 GitHub Releases，模型多来自 Hugging Face——官方文档提到，中国大陆用户可能需要配置代理才能稳定访问 GitHub。下载慢不是你操作错了。

系统要求：ComfyUI 显卡要求速查

官方给的硬件底线相当低：借助异步权重流（asynchronous weight streaming）技术，4GB 显存 + 8GB 内存也能跑最大的开源模型。各家显卡的支持情况：

硬件	支持情况
NVIDIA	近 10 年的卡都支持（GTX 900 系起）；官方建议 30 系及以上获得最佳性能，显存越大越好
AMD	Windows 包基于 ROCm，支持 RDNA 2 / 3 / 3.5 / 4 架构，无需另装 HIP SDK
Intel	Arc 系列（原生 torch.xpu 支持）
Apple Silicon	支持（M 系列），走 Mac 安装路线，见 备用安装
无独显	可用 CPU 模式跑（--cpu），只是慢

操作系统方面，Windows / Linux / macOS 都在官方支持列表里，但便携包只出了 Windows 版。Python 也不用你装：便携包自带独立 Python（当前为 3.13）和 PyTorch（NVIDIA 包当前为 CUDA 13.0 版）。

核心思路

ComfyUI 便携包是什么。 官方把 ComfyUI 主程序、一个独立的 Python 环境（python_embeded）和对应显卡的 PyTorch，打包成一个 7z 文件。所谓「安装」就是解压；所谓「启动」就是双击里面的 .bat 脚本——它用自带 Python 运行 ComfyUI\main.py，在你电脑上起一个本地服务。

界面在哪。 ComfyUI 是「本地服务 + 网页界面」的结构：启动后用浏览器访问 http://127.0.0.1:8188（127.0.0.1 就是「本机」的意思）。那个黑色命令行窗口就是服务本体——官方明确警告：使用期间别关它，关了 ComfyUI 就停止运行。

最关键的一步：按显卡选包。 官方为不同 GPU 出了不同的包，这是 ComfyUI 便携版安装里唯一容易选错的地方。三种本地安装方式先摆在一起：

安装方式	适合谁	一句话
Windows 便携包（本课）	Windows 用户，想最快跑起来	解压即用，自带 Python 与 PyTorch
Comfy Desktop 桌面版	想要图形安装器与自动更新	官方称对新用户最简单
macOS / Linux 手动安装	Mac（Apple Silicon）与 Linux 用户	git clone + pip 自己配环境

装好 ≠ 能出图。 安装包不含任何模型文件——第一个模型（官方教程用的 SD1.5，约 4GB）要自己下载放进 models 目录，这是 模型放哪里 那课的内容。

跟我做

第 1 步：确认显卡，选对 ComfyUI 下载包

为什么：官方按 GPU 类型分别打包，选错包可能导致启动失败或性能很差。

对照下表点击下载（文件都在 GitHub Releases 的最新版页面上）：

你的显卡	该下的包	文件名
NVIDIA RTX 20 系及以上	标准包（CUDA 13.0，Python 3.13）	ComfyUI_windows_portable_nvidia.7z
NVIDIA GTX 10 系及更旧	cu126 包（CUDA 12.6，Python 3.12）	ComfyUI_windows_portable_nvidia_cu126.7z
Windows on ARM + NVIDIA	ARM64 包（Python 3.14）	ComfyUI_windows_portable_nvidia_arm64.7z
AMD	AMD 包（ROCm）	ComfyUI_windows_portable_amd.7z
Intel	Intel 包	ComfyUI_windows_portable_intel.7z
没有独显	任意 NVIDIA 包，之后用 run_cpu.bat 启动	—

⚠️ 别给新卡下 cu126 包

官方 README 原话：cu126 包只给 GTX 10 系及更旧的显卡用，不要在 RTX 20 系及以上的新卡上使用。

你应该看到：浏览器开始下载一个文件名与上表一致的 .7z 文件。

• 下载的文件名和我的显卡对上了

第 2 步：解压 7z 包，ComfyUI 安装到此完成

为什么：便携包没有安装器，「解压」就是全部的安装动作。

操作：把 .7z 解压到一个空间充裕的位置（比如 D:\）。右键用 7-Zip 解压；较新版本的 Windows 资源管理器也能直接解压。

你应该看到：解压出一个文件夹，结构如下——这个结构后面每一课都会用到：

ComfyUI_windows_portable
├── ComfyUI                   ← 主程序（模型目录 models 也在里面）
├── python_embeded            ← 自带的独立 Python 环境
├── update                    ← 升级用的批处理脚本
├── README_VERY_IMPORTANT.txt ← 官方的便携包使用说明
├── run_cpu.bat               ← CPU 模式启动（无独显用，慢）
└── run_nvidia_gpu.bat        ← NVIDIA 启动（AMD 包是 run_amd_gpu.bat，Intel 包是 run_intel_gpu.bat）

• 我能找到 run_nvidia_gpu.bat（或对应我显卡的那个 .bat）

第 3 步：双击 .bat 启动 ComfyUI

为什么：.bat 会用自带的 Python 启动本地服务，这一步才是「开机」。

操作：双击对应你显卡的启动脚本：

• NVIDIA：run_nvidia_gpu.bat
• AMD：run_amd_gpu.bat
• Intel：run_intel_gpu.bat
• 无独显：run_cpu.bat

它做的事情就一行——run_nvidia_gpu.bat 里真正干活的是这一行（文件里还有一段官方排错提示和 pause，提示内容见下方「踩坑提醒」）：

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

你应该看到：黑色命令行窗口滚动日志，最后出现：

To see the GUI go to: http://127.0.0.1:8188

通常浏览器会自动打开并跳到这个地址；没自动打开，就自己开浏览器访问 http://127.0.0.1:8188——节点画布出现了，安装就成功了。

⚠️ 黑窗口别关

官方警告：使用期间不要关闭那个命令行窗口，否则 ComfyUI 会停止运行。想结束使用时关掉它，服务即停止，下次再双击 .bat 重新启动即可。

• 浏览器打开 http://127.0.0.1:8188，能看到节点画布

第 4 步：认识下一个目的地——模型目录

为什么：安装包不含模型，现在界面里 Load Checkpoint 还是空的，直接点生成会报红。装模型是下一课的事，这里先认个门。

操作：在资源管理器打开 ComfyUI_windows_portable\ComfyUI\models\checkpoints——你的第一个模型（官方教程用的 SD1.5 权重 v1-5-pruned-emaonly-fp16.safetensors）就放这里。

你应该看到：models 下有一排子文件夹（checkpoints、vae、loras 等）。目录规则详解与多软件共享模型的方法看 模型放哪里；放好模型后怎么出第一张图，看 第一次生图。

• 我知道第一个模型该放进 ComfyUI\models\checkpoints

检查点 ✅

• 下载的 .7z 文件名与我的显卡匹配（新卡没误下 cu126 包）
• 解压后能看到 run_nvidia_gpu.bat（或 run_amd_gpu.bat / run_intel_gpu.bat）和 update 文件夹
• 双击 .bat 后，命令行出现 To see the GUI go to: http://127.0.0.1:8188
• 浏览器打开 http://127.0.0.1:8188，能看到 ComfyUI 节点画布
• 我知道：黑窗口不能随手关；装好还不算完，模型要另外下载

踩坑提醒

❌ 双击 .bat 后黑窗口一闪而过，ComfyUI 没起来

run_nvidia_gpu.bat 里官方直接写了一段提示：如果看到提示而 ComfyUI 没启动，先把 NVIDIA 驱动更新到最新；如果报 c10.dll 错误，去装微软 VC++ 运行库，官方给的地址是 https://aka.ms/vc14/vc_redist.x64.exe。正确顺序：更新驱动 → 再双击；报 c10.dll → 装运行库。更多启动问题看 装不上怎么办。

❌ 给 RTX 30/40/50 系下了 cu126 包

cu126 包（CUDA 12.6）是给 GTX 10 系及更旧的显卡准备的，官方 README 用大写强调「不要在 20 系及以上使用」。正确做法：删掉重下标准包 ComfyUI_windows_portable_nvidia.7z（CUDA 13.0）。

❌ 解压报错，或解压后文件不全

Windows 会给从网上下载的文件加「锁定」标记，导致解压失败。官方 README 给的解法：右键 .7z 文件 → 属性 → 勾选「解除锁定」（Unblock）→ 确定，再重新解压。仍不行就换 7-Zip 解压。

❌ 浏览器能打开 127.0.0.1:8188，但界面白屏、花屏

官方系统要求写明：Chrome 142 及更早版本存在已知问题，会导致界面显示异常和性能问题。正确做法：把 Chrome 升级到 143 或更高版本再打开。

进阶技巧（可选）

🔧 升级便携版：update 文件夹里有三个官方脚本，双击即可：

脚本	作用
update\update_comfyui.bat	更新到最新开发版
update\update_comfyui_stable.bat	更新到最新稳定版
update\update_comfyui_and_python_dependencies.bat	⚠️ 连 Python 依赖一起重装，官方标注仅在依赖出问题时使用，运行前先备份整个安装目录

🔧 让局域网其他设备访问：用记事本打开 run_nvidia_gpu.bat，加上 --listen 参数（官方示例）：

.\python_embeded\python.exe -s ComfyUI\main.py --listen --windows-standalone-build
pause

重启后日志会显示 To see the GUI go to: http://0.0.0.0:8188。按 Win + R 输入 cmd 打开命令提示符，输入 ipconfig 查到本机 IP，其他设备用浏览器访问 http://<你的本机IP>:8188 即可。

🔧 给便携包装额外的 Python 包（自定义节点的依赖常要这么装）：

cd ComfyUI_windows_portable
.\python_embeded\python.exe -m pip install <包名>

国内 pip 慢，可以加清华镜像参数（官方文档也提到此方案）：-i https://pypi.tuna.tsinghua.edu.cn/simple。

🔧 官方自带的启动变体：NVIDIA 包里还有一个 run_nvidia_gpu_fast_fp16_accumulation.bat，启用 fp16 累加加速——官方说明是「对 fp16 模型更快、质量略降」；AMD 包则带 run_amd_gpu_enable_dynamic_vram.bat（加 --enable-dynamic-vram 参数）。

本课小结

✅ ComfyUI 安装（Windows 便携包路线）你已经走完：按显卡选包 → 解压 → 双击 .bat → 浏览器打开 http://127.0.0.1:8188。

✅ 你搞清了 ComfyUI 显卡要求：NVIDIA 新卡用标准包、GTX 10 系及更旧用 cu126 包；AMD / Intel 各有对应包；没有独显也能用 CPU 模式跑，官方底线低至 4GB 显存 + 8GB 内存。

✅ 你记住了三件事：黑窗口是服务本体、别乱关；安装包不含模型，第一个模型放 ComfyUI\models\checkpoints；升级用 update 文件夹的官方脚本。

文件 / 地址	作用
run_nvidia_gpu.bat	NVIDIA 启动脚本（AMD / Intel 包对应各自脚本）
run_cpu.bat	CPU 模式启动（加 --cpu 参数，慢）
update\update_comfyui.bat	升级到最新开发版
ComfyUI\models\checkpoints	第一个模型放这里
http://127.0.0.1:8188	ComfyUI 界面地址

下一课预告

Windows 便携包不是唯一的路：备用安装：Comfy Desktop、macOS 与 Linux 手动安装。

你会学到：

• Comfy Desktop 桌面版怎么装（官方称对新用户最简单）
• Mac（Apple Silicon）与 Linux 的安装路线
• 几种安装方式怎么选、装过之后能不能换

已经用便携包跑起来的 Windows 用户，也可以直接跳去 模型放哪里，早点出第一张图。