Windows 上装 ComfyUI 的四条路径：桌面版、portable、comfy-cli、手动装怎么挑
装 ComfyUI 这件事，最容易出问题的不是命令敲错，而是第一步就挑错了路子。一个很常见的选择是：上来就去下 Windows portable 包，因为「便携版看起来更专业」。而 ComfyUI 官方仓库（github.com/Comfy-Org/ComfyUI）的 README 在 Installing 章节里写的原话恰恰相反：“It is not recommended for regular users. Regular users should use the desktop app above.”——普通用户不推荐用 portable，该用上面那个桌面应用。
下面按官方 README（核对日 2026-08-09，对应 core 版本 v0.31.0）的口径，把 Windows 上这四条路径的定位、命令、验收方式和各自的失效场景摆清楚。
一、先看官方给的定位差异
README 的 Get Started / Installing 章节列出的是四种方式，其中三种落在本地，一种在云上：
| 方式 | README 原始定位 | 平台 |
|---|---|---|
| Desktop Application | ”The easiest way to get started.”；README 写「我们强烈推荐使用桌面应用」「对新用户是最简单也是最好的方式」 | Windows & macOS |
| Windows Portable Package | ”Get the latest commits and completely portable.”；同时明确写对普通用户不推荐 | Windows |
| Manual Install | 支持所有操作系统与 GPU 类型（NVIDIA、AMD、Intel、Apple Silicon、Ascend） | 全平台 |
| Comfy Cloud | 官方付费云版本，面向「买不起本地硬件」的用户 | 云端 |
除了上面这张表，README 还单给了一条 comfy-cli 的安装命令。它在 Windows 本地就是一条现成的可选路径，所以本篇按「桌面版 / portable / comfy-cli / 手动装」这四条讲，Comfy Cloud 放到最后一节的「都不该走」里一起说。
这张表最值得读的一行是 portable 那行。它的定位关键词是「拿到最新 commit」+「完全便携」，不是「更专业的版本」。也就是说，选它的理由应该是你需要贴着最新提交跑、或者需要整个目录拷走即用，而不是「我觉得我不是普通用户」。
二、桌面版：默认就该选它
如果你在 Windows 上第一次装，且没有「必须跟最新 commit」的硬需求，README 的答案很直白：装桌面应用。
它的发布口径也值得知道一下。README 的 Release Process 章节写明，Comfy Desktop（github.com/Comfy-Org/Comfy-Desktop）是用最新 stable core 版本构建发布的；而 core 大约每两周发一个 major stable 版本，stable release tag 之外的 commit「可能非常不稳定，会弄坏很多自定义节点」。桌面版天然站在 tag 这一侧，这就是它对新手友好的结构性原因——你不需要自己去判断今天 master 上那堆提交能不能用。
什么情况不适用：你要跟的功能刚合进 master 还没发 tag；或者你需要在同一台机器上跑多个隔离环境、需要把整套东西塞进移动硬盘带走；或者你根本不在 Windows/macOS 上（Linux 没有桌面版这一格）。
三、portable：四个包，选错一个直接白装
portable 的下载地址形如 github.com/comfyanonymous/ComfyUI/releases/latest/download/<包名>，README 给了四个包：
| 包 | 文件名 | 适用范围（README 原文要点） |
|---|---|---|
| NVIDIA | ComfyUI_windows_portable_nvidia.7z | supports 20 series and above |
| NVIDIA 旧卡 | ComfyUI_windows_portable_nvidia_cu126.7z | pytorch cuda 12.6 + python 3.12，Supports Nvidia 10 series and older GPUs，DO NOT USE THIS ON NEWER 20 SERIES AND ABOVE GPUS |
| AMD | ComfyUI_windows_portable_amd.7z | AMD GPUs |
| Intel | ComfyUI_windows_portable_intel.7z | Intel GPUs |
第二行那句全大写的 DO NOT USE 是 README 自己写的，不是我加的强调。10 系及更老的卡要用 cu126 那个包，而 20 系及以上不要用它。反过来，默认那个 nvidia 包 README 说明它自带 python 3.13 与 pytorch cuda 13.0；如果它起不来，README 给的处置就一句话：更新 NVIDIA 驱动。至于驱动版本要求多少，README 没写，别去网上找版本号硬套。
解压环节 README 也给了两条：用 7-Zip 或较新版本 Windows 的资源管理器解压即可；解压出问题时，右键文件 → 属性 → 解除锁定（unblock）。README 只把这一步放在「解压有问题时」的位置，没有解释背后的机制，但它排在最前面，遇到解压异常先做这一步的成本几乎为零。
模型放置规则同样在 README 里：小模型只要把 ckpt/safetensors 放进 ComfyUI\models\checkpoints；很多大模型是多个文件，要按各自说明放进 ComfyUI\models\ 下对应的子目录。别把整包模型一股脑丢进 checkpoints。
什么情况不适用：你是第一次接触、又不打算研究目录结构和 CUDA 版本——README 直接把你劝到桌面版去了。另外 portable 是「跟最新 commit」的定位，这意味着自定义节点被弄坏的概率也跟着上去，介意这个就别走这条。
四、comfy-cli：一条命令拉起来
README 给的命令只有两行：
pip install comfy-cli
comfy install
第一行装 CLI 工具本身，第二行由它去完成 ComfyUI 的安装。这条路径的价值在于你已经有一个自己管的 Python 环境（conda / venv / uv 都算），希望安装动作可脚本化、可重复，而不是手工点安装包。
需要说清楚的是：README 在这里只给了这两行命令，没有给出各平台的分支处理、也没有给出失败后的排查步骤。所以别指望它能替你解决驱动、CUDA、torch 版本这些底层问题——这些坑在手动装那一节里的规则同样适用于它。
什么情况不适用：你连 pip 装到哪个解释器里都不确定的时候。pip install comfy-cli 装进了哪个环境，后续 comfy install 的行为就跟着那个环境走，这是新手最容易搞混的一层。
五、手动装：把 Python 与 torch 的版本规则先看完
手动装是唯一全平台通吃的路径，代价是版本矩阵得你自己对。README 的 Manual Install 章节把话说得很细：
| 项 | README 原文要点 |
|---|---|
| Python 3.14 | 能用，但某些自定义节点可能有问题；free threaded 变体能用，但部分依赖会启用 GIL，所以不算完全支持 |
| Python 3.13 | very well supported（支持得很好） |
| Python 3.12 | 如果在 3.13 上遇到自定义节点依赖问题，可以退回 3.12 |
| torch 2.7 | 最低支持版本（minimally supported），但极力推荐用更新的版本 |
| cu130 及以上 | 在 NVIDIA 20 系及以上是必需的（required） |
| 版本策略 | 一般推荐最新 major 版 pytorch + 最新 cuda 版本，除非它发布不足 2 周；如果你的 pytorch 超过 6 个月没更新，请更新它 |
这张表的读法：3.13 是主路，3.12 是退路，3.14 是探路。 3.14 不是「更新更好」，README 对它的措辞是「不算完全支持」，问题面正好落在自定义节点上——而自定义节点恰恰是大多数人用 ComfyUI 的理由。所以除非你有明确理由，别把 3.14 当默认。
NVIDIA 卡装 torch 的稳定版命令是：
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
想跟 nightly 的话 README 另给了一条：
pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu132
注意两条命令用的参数不一样，稳定版是 --extra-index-url，nightly 是 --index-url，nightly 还多一个 --pre。这不是笔误，照抄就行，别自己「统一」成一种写法。
torch 装好后，在 ComfyUI 目录内装依赖并启动：
pip install -r requirements.txt
python main.py
如果你要把 base 目录挪到别处，可以这样组合：
python main.py --base-directory <你的 ComfyUI 目录>
以上为按官方参数语义组合的示例，未逐项实测，以官方文档与 --help 输出为准。
顺带说一句依赖文件本身的坑。v0.31.0 时点的 requirements.txt 里，comfyui-frontend-package==1.48.7、comfyui-workflow-templates==0.11.37、comfyui-embedded-docs==0.5.9 这三个包是用 == 精确 pin 的。这意味着升级 core 会连带换掉前端版本——这就是为什么「升级之后前端出问题」这类现象，得连着 core 版本一起看，而不是单独去折腾前端。
六、装完怎么验收
先说清楚装完之后手上应该有什么。四条路径的落点不完全一样，但对照 README 能确认的产出物是这几样：一个 ComfyUI 目录，目录下有 requirements.txt，有 ComfyUI\models\ 及其下的 checkpoints 等子目录；用 portable 的 standalone windows 构建时，extra_model_paths.yaml.example 也在这个 ComfyUI 目录下；能用 python main.py 把服务起起来。除此之外，README 并没有给出一份完整的启动日志样例，所以任何声称「日志第几行应该打印什么」的说法都要打问号。有依据的验收点只有下面这几处，按顺序过一遍就够用了。
第一处，python main.py 能不能起来，以及有没有报 “Torch not compiled with CUDA enabled”。这是 README 的 Troubleshooting 章节里唯一给出的一条故障，处置也是唯一的一条：
pip uninstall torch
卸掉之后，按你自己硬件对应的那条命令重新装 torch。README 对这条错误给的处置就只有「卸掉重装」这一种，没有给任何改配置绕过去的做法。
第二处，如果你用了 --base-directory，v0.26.0（2026-06-23）起会把 base 目录打进启动日志（PR #13370）。这是 release notes 里能确认的一条启动日志输出，也正好值得确认——你以为模型放在 A 目录、程序其实在读 B 目录的话，界面上就是刷不出模型，而日志这一行能直接告诉你程序在读哪里。
第三处，模型目录。确认 ckpt/safetensors 确实落在 ComfyUI\models\checkpoints，多文件的大模型按官方说明落在 ComfyUI\models\ 下对应子目录。如果你要跟其它 UI 共享模型，README 指向仓库里的 extra_model_paths.yaml.example：把它改名为 extra_model_paths.yaml 再编辑即可设置模型搜索路径；standalone windows 构建里，这个文件就在 ComfyUI 目录下。
第四处，卡型与包是否对得上。20 系及以上却装了 cu126 那个 portable 包，或者手动装时用了低于 cu130 的轮子，这两种情况都属于 README 明确点名的雷区，越早发现越省事。
最容易出错的一步，按 README 自己的强调程度排，是选包/选 CUDA 版本这一步——README 为它专门用了全大写的 DO NOT USE，还单列了一条 cu130 的必需项；其次是解压后没解除锁定，这一步 README 是作为解压异常的处置给出的。
七、什么情况这四条都不该走
- 机器本身没有合适的 GPU、又不想折腾环境：README 给 Comfy Cloud 的定位就是面向「买不起本地硬件」的用户，这时候硬装本地版是给自己找事。
- 你需要的是 Linux / Apple Silicon / Ascend NPU / Cambricon MLU / Iluvatar 这类环境：桌面版和 portable 都不覆盖，只能走手动装。而对后面几类国产与异构平台，README 只给了「按官方页面说明依次安装」的顺序，没有给具体命令和版本号，别在网上找来路不明的版本号硬套。
- 你在给团队做可复现的部署：这四条路径里没有任何一条自带版本锁定语义（portable 甚至明说是跟最新 commit 的）。要可复现，得自己把 core 版本、Python 版本、torch 版本、
requirements.txt里那三个 pin 住的包版本一起记录下来，并按 README 的规则跟 stable tag 而不是 master。 - AMD 卡在 Windows 上：README 把 Windows 侧的 AMD 构建标注为 Experimental，且只覆盖 RDNA 3、3.5、4，并注明这些构建比 Linux 上的 ROCm 构建硬件支持更少。属于可以试、但不该作为主力生产路径的状态。
最后提醒一句版本时效。ComfyUI 大约每两周一个 major stable 版本，本文对应的是 v0.31.0（2026-08-08）。上面每一条命令、每一个版本门槛，都可能在下一个周期变动，动手前先去 README 对一眼，比装完再回头排查省事得多。
延伸阅读
- 桌面版 / portable / 手动装：ComfyUI 三条安装路怎么选
- 让 ComfyUI 和别的 UI 共享同一份模型目录
- 四个 portable 包别下错：ComfyUI Windows 便携版的选包与落地流程
本文依据 ComfyUI 官方仓库（github.com/Comfy-Org/ComfyUI）的 README、comfy/cli_args.py、
release notes 与官方安全公告整理，核对日 2026-08-09，对应版本 v0.31.0；
文中引用的 issue 状态为该日期的快照。本文内容为官方文档与源码口径，非本机实测。
参数、默认值与功能随版本变动，请以官方文档与 python main.py --help 的实际输出为准。