ComfyUI 零基础安装指南（Windows / Mac / 云端三种方式）

想用 AI 生图、生视频，ComfyUI 基本是绕不开的工具：免费、开源，新模型一出来，社区很快就能用上。不少人卡在第一步“装不上”，这篇就从零讲起，带你把 ComfyUI 跑起来。

读完这篇你会知道：

• 你的电脑能不能跑 ComfyUI
• 该选哪种安装方式（Windows / Mac / 云端）
• 每种方式怎么一步步装
• 装好之后遇到报错怎么办

💡 本文内容依据 ComfyUI 官方文档（docs.comfy.org）整理，写于 2026 年 10 月。ComfyUI 更新很快，遇到和文中不一样的地方，以官方页面为准。

一、先看配置：我的电脑能跑吗？

支持的系统

• Windows（官方桌面版要求 Windows 10 及以上）
• macOS：需要 Apple Silicon（M1 及以后的芯片），官方桌面版要求 macOS 13（Ventura）及以上。Intel 芯片的 Mac 不在桌面版支持范围内
• Linux

显卡（最关键）

显存（VRAM）怎么看？ 官方系统要求页没有给出具体的显存数值，只列出了支持的显卡类型。一般来说显存越大，能跑的模型越大、速度也越快；不同模型对显存的要求差别很大，具体请以各模型的官方说明为准（核对于 2026-10-16，来源：docs.comfy.org 系统要求）。

显存不够也别急，后面有专门的文章讲低显存技巧，实在不行可以用云端。

硬盘空间

ComfyUI 程序本身不大（官方 macOS 桌面版要求写明：每个安装建议至少预留 4.85 GB 磁盘空间，来源：docs.comfy.org，核对于 2026-10-16），真正占空间的是模型，一个模型动辄几个到十几个 GB。建议准备一块空间充足的硬盘（最好是固态硬盘）专门放模型。

浏览器

ComfyUI 的界面在浏览器里打开。官方原文：为获得最佳体验，请使用 Google Chrome 143 或更新版本；Chrome 142 及更早版本存在已知问题，可能导致界面显示异常和性能问题（来源：docs.comfy.org 系统要求，核对于 2026-10-16）。

二、选哪种安装方式？

一句话建议：

• Windows + N 卡 → 桌面版或便携包都行
• Mac（M 芯片）→ 桌面版
• 电脑配置不够 → 云端

三、方式一：Windows 安装

方法 A：Comfy Desktop 桌面版（推荐新手）

官方桌面版是一键安装程序，自带自动更新，适合 Windows 10 及以上、使用 NVIDIA 或 AMD 显卡的电脑。

1. 打开官方下载页：https://www.comfy.org/download（会自动识别你的系统）
2. 下载 Windows 安装程序，双击运行
3. 按安装向导提示完成安装，首次启动时按提示选择显卡类型和安装位置
4. 等它自动下载、配置好运行环境，看到 ComfyUI 界面就成功了

桌面版默认跟随 ComfyUI 的稳定版更新。想第一时间用最新功能，可以选便携包或手动安装。

方法 B：Windows 便携包（Portable）

便携包是一个打包好的完整 ComfyUI，自带独立的 Python 环境，解压就能用，不会影响你电脑上的其他软件。

第 1 步：选对版本下载

在官方便携包页面（https://docs.comfy.org/installation/comfyui_portable_windows）按显卡选择：

• NVIDIA 新显卡（RTX 系列）：选「Nvidia GPU (CUDA 13.0, Python 3.13)」
• NVIDIA 10 系及更老显卡：选「Nvidia GPU (CUDA 12.6, Python 3.12)」

（以上版本号来自官方便携包页面，核对于 2026-10-16。）

• AMD 显卡：选 AMD（ROCm）版本
• Intel 显卡：选 Intel 版本

第 2 步：用 7-Zip 解压

下载下来是压缩包，建议用免费的 7-Zip 解压。路径尽量不要有中文和空格，比如放在 D:\AI\ 下。解压后大概是这样：

ComfyUI_windows_portable
├── ComfyUI                  // 主程序
├── python_embeded           // 自带的 Python 环境
├── update                   // 更新脚本
├── run_cpu.bat              // CPU 模式启动
└── run_nvidia_gpu.bat       // N 卡启动（AMD/Intel 版对应 run_amd_gpu.bat / run_intel_gpu.bat）

第 3 步：双击启动

N 卡用户双击 run_nvidia_gpu.bat。会弹出一个黑色命令行窗口，看到这行字就说明启动成功：

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

一般浏览器会自动打开；没打开的话，手动在浏览器输入 http://127.0.0.1:8188 即可。

⚠️ 使用过程中不要关掉那个黑色窗口，关掉 ComfyUI 就停了。

以后怎么更新？ 进入 update 文件夹：

• update_comfyui_stable.bat：更新到最新稳定版（推荐）
• update_comfyui.bat：更新到最新开发版
• update_comfyui_and_python_dependencies.bat：只在运行环境出问题时用

四、方式二：Mac 安装（Apple Silicon）

配置要求

• macOS 13（Ventura）或更新
• Apple Silicon（M1 及以后）
• 每个安装建议至少预留 4.85 GB 磁盘空间（官方原文，不含模型；核对于 2026-10-16）

安装步骤

1. 打开 https://www.comfy.org/download，下载 macOS 版安装包（.dmg）
2. 双击打开 .dmg，把 Comfy Desktop 拖进「应用程序」文件夹
3. 从启动台或聚焦搜索（Spotlight）打开它
4. 第一次打开如果提示“无法验证开发者”之类的安全警告：打开 系统设置 → 隐私与安全性，点击 仍要打开
5. 按提示创建一个 ComfyUI 安装（实例），等待环境配置完成即可

Mac 上 ComfyUI 是通过 PyTorch 的 MPS（Metal）后端调用 GPU 加速的。同样的模型，Mac 通常比同价位 N 卡慢一些，生视频尤其明显，这很正常。

更新与卸载

• 更新：有新版本时，窗口顶部会出现 “Desktop Update Ready” 按钮，点一下自动重启更新
• 卸载：把应用拖进废纸篓即可。注意这样不会删除你的模型和作品，它们默认在 ~/ComfyUI-Installs 和 ~/ComfyUI-Shared 里，需要的话手动删除

五、方式三：手动 git 安装（进阶，全平台）

适合有一点命令行基础的朋友，好处是完全可控、随时用最新代码。不熟悉命令行的话，建议先用上面的桌面版。

准备： 安装 Git 和 Miniconda。Windows 用户还需要安装 Microsoft Visual C++ 运行库。

1. 创建独立的虚拟环境（避免和系统 Python 冲突。官方说明：Python 3.13 支持很好、推荐使用；3.14 可用但部分自定义节点可能有问题；某些自定义节点依赖在 3.13 上有问题时，3.12 是不错的备选。来源：docs.comfy.org 系统要求，核对于 2026-10-16）

conda create -n comfyenv python=3.13
conda activate comfyenv

2. 下载 ComfyUI 代码

git clone https://github.com/Comfy-Org/ComfyUI.git

3. 安装 PyTorch（按显卡选一条）

NVIDIA（官方写明：安装带 CUDA 13.0 的稳定版 PyTorch；20 系及以上 N 卡需要 cu130 或更高版本的 PyTorch）：

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

Mac（Apple Silicon）：

conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly

Intel Arc：

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

AMD 显卡的命令区分 Windows / Linux，且和具体型号有关，请直接照官方手动安装页面操作。

4. 安装 ComfyUI 依赖并启动

cd ComfyUI
pip install -r requirements.txt
python main.py

看到 http://127.0.0.1:8188 后用浏览器打开即可。以后更新：进入 ComfyUI 目录执行 git pull，再在虚拟环境里执行一次 pip install -r requirements.txt。

官方目前没有提供官方 Docker 镜像，网上的 Docker 镜像都是社区维护的，使用需自担风险。

六、方式四：云端使用（不用装、不挑电脑）

如果你的电脑没有独立显卡，或者显存太小，最省事的是直接用云端。

Comfy Cloud（官方云端）

ComfyUI 官方提供了 Comfy Cloud：在浏览器里直接用完整的 ComfyUI，背后是官方的高性能 GPU，常用模型已经预装好。官方说法是：本地做的工作流，拿到 Cloud 上直接能用，效果一致。很多人的用法是平时本地搭工作流，重活（比如生视频）丢到云端跑。

入口：https://www.comfy.org → Comfy Cloud。Cloud 是官方提供的在线服务，使用方式和相关说明详见官方定价页。

第三方云算力平台

也可以在各类 GPU 云平台上租显卡，用别人做好的 ComfyUI 镜像。优点是灵活、显卡选择多；缺点是需要自己挑镜像、用完记得及时关机。

七、常见报错与解决办法

1. 双击 run_nvidia_gpu.bat 闪退 / 启动失败

• 先更新 NVIDIA 显卡驱动（官方明确说便携版启动不了时先更新驱动）
• 老显卡（10 系及以前）确认下载的是 CUDA 12.6 那个版本
• 检查解压路径是否含中文、空格或特殊字符

2. 提示 Torch not compiled with CUDA enabled 或找不到显卡

• 手动安装时装成了 CPU 版 PyTorch。在虚拟环境中卸载 torch 后，按上面对应显卡的命令重装
• Intel 显卡不要装 CUDA 版的包

3. 生成时报 out of memory（显存不足）

• 降低图片分辨率、批量数改为 1
• 换小一点的模型
• 关掉其他占显存的程序（游戏、视频剪辑软件等）
• 还是不行就上云端

4. 浏览器打不开 127.0.0.1:8188

• 确认黑色命令行窗口还开着，且已出现 “To see the GUI go to” 那行
• 换 Chrome 最新版试试
• 检查端口 8188 是否被其他程序占用

5. 界面错乱、按钮显示不全

• 升级到 Chrome 143 或更高版本（官方推荐），清一下浏览器缓存

6. Mac 提示“无法打开，因为无法验证开发者”

• 系统设置 → 隐私与安全性 → 仍要打开

7. 下载模型或依赖特别慢

• 模型文件很大，网络慢时耐心等待；可以先下载好再放到对应的 models 子文件夹里

八、FAQ

Q：ComfyUI 是开源软件吗？ A：是的。本地版开源（GPL-3.0 协议），可以自由下载使用，没有功能限制。官方云端 Comfy Cloud 是另外的在线服务，说明见上文。

Q：没有独立显卡能用吗？ A：能用 CPU 模式，但速度很慢，体验不好。建议直接用云端。

Q：桌面版、便携包、手动安装有什么区别？ A：桌面版是一键安装 + 自动更新，最省心；便携包自带环境、放哪都能跑，能用最新功能（仅 Windows）；手动安装适合开发者，完全自己掌控。

Q：Intel 芯片的老 Mac 能装吗？ A：官方桌面版要求 Apple Silicon（M1 及以后），Intel Mac 不在支持范围内，建议用云端。

Q：我之前装过 Stable Diffusion WebUI，模型能共用吗？ A：可以。通过 extra_model_paths.yaml 配置文件，让 ComfyUI 读取 WebUI 的模型目录，不用重复下载。

Q：插件（自定义节点）怎么装？ A：用 ComfyUI Manager，可以在软件里直接搜索、安装、更新插件。

Q：怎么关闭 ComfyUI？ A：在运行它的命令行窗口按 Ctrl + C，或直接关掉窗口；桌面版直接退出应用即可。

九、下一步：生成你的第一张 AI 图 🎨

装好了 ComfyUI，打开界面却一脸懵？别担心，第一次出图大致就是这几步：下载第一个模型 → 认识默认工作流 → 写提示词 → 点击生成。

装的过程中遇到问题？建议先对照上面的常见报错和官方故障排查文档排查。

参考资料：ComfyUI 系统要求、macOS 桌面版、Windows 便携包。以上内容均核对于 2026-10-16。