ComfyUI 安装教程：桌面版、Windows 便携版与手动安装

ComfyUI 有几种安装方式，请根据你的电脑和需求选择：

方式	适用场景	系统
Desktop 桌面版	初次使用，想快速开始	Windows、macOS
Windows 便携版（portable）	想把整个环境放在一个文件夹中，方便迁移	Windows
手动安装	Linux、服务器，或想完全掌控环境	全部

方法一：ComfyUI Desktop（推荐新手）

前往 ComfyUI 官网（comfy.org）下载 Desktop 版本。
运行安装程序，按照向导步骤操作：
- 选择 GPU 类型（NVIDIA、Apple Silicon 等）
- 选择安装位置（建议选择空间充足的硬盘，模型会保存在这里）
- 如果之前已经安装过 ComfyUI，可以导入现有的模型和设置
安装程序会自动下载 Python 和相关依赖。完成后直接打开界面。

桌面版内置了 ComfyUI-Manager（自定义节点管理）和自动更新功能。

方法二：Windows 便携版

前往 ComfyUI 的 GitHub 页面（Releases）下载便携版压缩包。根据显卡选择对应版本（主要是 NVIDIA；也有 AMD、Intel 版本）。
使用 7-Zip 解压到空间充足的位置，例如 D:\ComfyUI_windows_portable。路径中避免中文和空格。
运行文件夹中的：
- run_nvidia_gpu.bat：使用 NVIDIA 显卡
- run_cpu.bat：仅使用 CPU（非常慢）
终端窗口出现 To see the GUI go to: http://127.0.0.1:8188 后，在浏览器中打开这个网址。

便携版内含独立的 Python，不会影响电脑上的其他程序。要更新时，运行 update 文件夹中的更新脚本。

太旧的 NVIDIA 显卡（例如 GTX 10 系列）可能需要选择官方标注支持旧显卡的版本。

方法三：手动安装

适合 Linux 用户或想自行管理环境的人。需要先安装 Git 和 Python（建议使用官方 README 推荐的版本，目前为 3.12～3.13）。

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
python -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate

安装 PyTorch

根据显卡安装对应版本的 PyTorch（版本号会随时间更新，请以 ComfyUI README 或 PyTorch 官网为准）：

# NVIDIA
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# AMD（Linux，ROCm）
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

# Intel 显卡
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

Apple Silicon Mac：根据 Apple 的 PyTorch Metal 说明安装 PyTorch。

安装依赖并启动

pip install -r requirements.txt
python main.py

打开 http://127.0.0.1:8188。

也可以使用 comfy-cli

pip install comfy-cli
comfy install
comfy launch

常用启动参数

python main.py --listen 0.0.0.0 --port 8188

参数	说明
`--listen 0.0.0.0`	允许局域网中的其他电脑连接（默认仅限本机）
`--port 8188`	指定端口
`--lowvram`	显卡内存不足时使用，速度较慢
`--cpu`	仅使用 CPU
`--preview-method auto`	生成过程中显示预览图
`--enable-manager`	启用 ComfyUI-Manager（手动安装时，需要先安装其依赖）

便携版需要添加参数时，使用文本编辑器修改 run_nvidia_gpu.bat 中的 python main.py 那一行。

使用 --listen 开放给其他电脑时，ComfyUI 没有账号密码保护，请仅在可信的内网中使用。

确认 GPU 正在使用

启动时的终端信息会显示检测到的设备，例如：

Total VRAM 12288 MB, total RAM 32671 MB
Device: cuda:0 NVIDIA GeForce RTX 4070 : cudaMallocAsync

如果显示的是 CPU，说明 PyTorch 的 GPU 版本没有正确安装。

更新

Desktop：自动提示更新。
便携版：运行 update/update_comfyui.bat。

手动安装：

git pull
pip install -r requirements.txt

更新后如果自定义节点出错，通常是自定义节点也需要更新，参见自定义节点与 Manager。

下一步

安装完成后，ComfyUI 还不能生成图片，因为还没有模型。先查看界面导览，再前往模型下载与文件夹下载第一个模型。

更新于 2026年10月12日