ComfyUI 是什么
ComfyUI 是一款基于节点的 Stable Diffusion 图形界面工具，通过可视化工作流让你自由组合各类 AI 模型，生成图像和视频。相比 WebUI 等工具，ComfyUI 更灵活、资源占用更低，适合需要精细控制生成流程的用户。
系统要求
| 平台 | 最低要求 |
|---|---|
| Windows | NVIDIA 显卡（GTX 10 系列及以上），16GB+ 内存 |
| macOS | Apple Silicon 芯片（M1/M2/M3/M4），16GB+ 统一内存 |
| 存储 | 至少 15GB 可用空间（SSD 推荐） |
macOS 上 VRAM 与系统内存共享，生成图片时建议关闭占用内存较多的应用。
方法一：ComfyUI Desktop 桌面应用（推荐新手）
官方桌面应用是最简单的安装方式，自动管理 Python 环境和依赖。
下载
- Windows：https://download.comfy.org/windows/nsis/x64
- macOS：https://download.comfy.org/mac/dmg/arm64
- macOS 也可用 Homebrew：
brew install comfyui
安装
Windows：
- 双击下载的
.exe安装包 - 按提示完成安装，桌面会生成快捷方式
macOS：
- 打开下载的
.dmg文件 - 将 ComfyUI 拖入
Applications文件夹
首次启动配置
启动后进入初始化设置：
第一步：选择 GPU 模式
- Windows 选择 NVIDIA（推荐）
- macOS 选择 MPS（推荐）——使用 Metal Performance Shaders 进行 GPU 加速
第二步：选择安装位置
选一个空文件夹存放 Python 环境、模型和自定义节点。路径避免中文和特殊字符。
第三步：迁移旧安装（可选）
如果之前装过 ComfyUI，可以关联已有模型文件（不会复制，仅建立链接）。
第四步：偏好设置
- 自动更新：建议开启
- 使用分析：可选关闭
- 镜像设置：国内网络受限时配置
国内镜像配置
如果初始化时出现红色 ❌ 提示网络错误，可配置以下镜像：
Python 安装镜像：
https://python-standalone.org/mirror/astral-sh/python-build-standalonePyPI 镜像（任选其一）：
https://mirrors.aliyun.com/pypi/simple/https://mirrors.cloud.tencent.com/pypi/simple/https://pypi.mirrors.ustc.edu.cn/simple/方法二：Windows 便携包（免安装）
适合 NVIDIA 显卡用户，开箱即用，不污染系统环境。
步骤
- 前往 ComfyUI GitHub Releases 下载最新便携包
- 用 7-Zip 解压到任意目录
- 运行
run_nvidia_gpu.bat（有 NVIDIA 显卡）或run_cpu.bat（仅 CPU） - 浏览器访问
http://127.0.0.1:8188
便携包自带 Python 3.13 和 PyTorch CUDA 13.0，无需额外配置。
如果是 GTX 10 系列老显卡，下载 PyTorch CUDA 12.6 版本的便携包。
方法三：手动安装（高级用户）
适合 AMD 显卡、需要最新功能、或想自定义环境的用户。
前置条件
- Python 3.10–3.13（推荐 3.13）
- Git
通用步骤
git clone https://github.com/comfyanonymous/ComfyUI.gitcd ComfyUIpip install -r requirements.txtpython main.py根据 GPU 安装对应 PyTorch
NVIDIA 显卡（CUDA 13.0）：
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130NVIDIA 显卡（CUDA 12.6，老显卡）：
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu126AMD 显卡（RX 7000 系列）：
pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-all/Apple Silicon（macOS）：
# 安装 PyTorch nightly 版本以获得 MPS 加速pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cpumacOS 额外步骤
brew install ffmpegpython main.py模型文件存放位置
安装完成后需要下载模型才能生成图片。将 .safetensors 格式的模型放入：
- 桌面版 / 便携包：安装目录下
ComfyUI/models/checkpoints/ - 手动安装：克隆仓库下
models/checkpoints/
模型下载来源
- Hugging Face — 开源模型集散地
- Civitai — 社区模型分享平台
入门推荐下载 SDXL 或 SD 1.5 的基础模型。
VRAM 管理建议
| 显存 | 启动参数 | 说明 |
|---|---|---|
| 8GB | --lowvram | 较慢但可运行大模型 |
| 12GB | 默认 | 大多数工作流正常运行 |
| 16GB+ | --highvram | 保持模型常驻显存，速度最快 |
macOS 用户无需额外设置显存参数，系统会自动管理统一内存。
卸载方法
Windows
- 桌面版：设置 → 应用 → 卸载 ComfyUI。完全清除还需删除：
%AppData%\ComfyUI%LocalAppData%\@comfyorgcomfyui-electron-updater
- 便携包：直接删除解压目录
macOS
- 将应用拖入废纸篓
- 完全卸载需删除：
~/Library/Application Support/ComfyUI
常见问题
Q：安装时提示 Git 未找到
前往 git-scm.com 下载安装 Git，安装后重启终端。
Q：macOS 打开应用时显示 🚫 符号
说明你的 Mac 不是 Apple Silicon 芯片（Intel Mac 不支持桌面版）。
Q：Windows 生成图片时显示 CUDA out of memory
尝试加 --lowvram 参数启动，或降低生成分辨率。
Q：国内下载速度很慢
桌面版在初始化时配置镜像（见上文）；手动安装可用 pip 镜像加速：
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/