手动安装 ComfyUI：把 Python、PyTorch 和节点依赖放在独立环境

用途与适用范围

这份指南用于规划一个可识别、可回退的手动安装环境。重点不是给所有机器同一条 pip 命令，而是先确定设备后端、受支持 Python 与独立工作目录。Desktop 和 Portable 用户不应直接照搬手动环境命令。

已核对的依据

官方手动安装和 PyTorch 安装页按平台提供条件选择，pip check 可检查包声明的依赖关系。通过 pip 检查不能证明 GPU 内核、模型或工作流已经成功运行。 D05 P04 P08

开始前需要分清的事项

1. 确认操作系统、GPU 型号、可用磁盘空间以及打算采用的计算后端。

2. 从项目官方发布入口取得源码，并根据当前文档选择受支持的解释器。

3. 保留当前已正常运行环境，不在它里面试装大量不相关节点。

操作与检查步骤

以下步骤是基于所列资料编排的操作建议；具体文件、版本和运行环境仍需按实际项目核对。

第 1 步。 在独立目录创建虚拟环境，并在终端确认 sys.executable 指向该环境。安装目录、模型存储和输出目录可以分别规划。

第 2 步。 根据 PyTorch 官方选择器安装适合设备和平台的组合；不要仅因为教程出现 CUDA 就给所有 Mac、AMD 或 CPU 环境使用相同命令。

第 3 步。 在同一环境安装 ComfyUI 当前 requirements，完成后检查依赖声明与基本 Torch 导入，记录实际版本。

第 4 步。 启动核心服务，先导入作者最小基础流程；核心可用后再一次加入一个必要扩展，保存变更记录。

可复制的检查命令

选择好受支持的 Python 后，可创建环境：

python -m venv .venv

激活方式按系统选择，不要两套都执行：

# Windows PowerShell
.\.venv\Scripts\Activate.ps1

# Linux / macOS
source .venv/bin/activate

随后先执行 python -c "import sys; print(sys.executable)" 核对环境；如系统策略限制激活，可直接调用环境内解释器，不建议为此全局放宽脚本策略。

完成后的检查

解释器路径、核心版本、Torch 后端和实际启动目录都有记录；服务启动且小工作流通过，才进入扩展安装阶段。

注意事项与尚未确认的部分

本文没有执行你的设备安装。系统驱动、内核和外部工具仍有各自条件，虚拟环境不会把所有系统依赖一起隔离。

资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• D05 · ComfyUI manual installation。核对：2026-09-21。
• P04 · PyTorch local installation。核对：2026-09-21。
• P08 · pip check。核对：2026-09-21。

相关排查与操作

• Portable 的 Python 到底是哪一个：安装依赖与启动路径指南
• pip ResolutionImpossible：两个节点的依赖冲突怎么处理
• torch.cuda.is_available() 为 False：构建、驱动和容器逐层检查