[安装指南](/zh/install "安装指南")[1. 安装 ComfyUI](/zh/install/install-comfyui "1. 安装 ComfyUI")1.1 ComfyUI Desktop
### [Qwen-Image-Layered 发布 - 支持图像分层编辑的生成模型](/zh/news/2025-12-19-qwen-image-layered-release)
2025/12/19
# ComfyUI Desktop 安装使用指南
**ComfyUI Desktop** 是 ComfyUI 官方推出的桌面端一键安装版本，可以像常规软件一样安装，支持快捷安装、自动配置 Python 环境及依赖，并支持导入已有的 ComfyUI 设置、模型、工作流和文件。
ComfyUI Desktop 是一个开源项目，完整代码请访问 [GitHub 仓库](https://github.com/Comfy-Org/desktop)。
ComfyUI Desktop 总是基于稳定版本构建的，这意味着它的更新总是滞后于开发版本或者便携版本的更新，如果你想要体验最新的功能可以尝试手动安装或者使用便携版本。
## 系统要求
* **Windows 版本** ：需要 NVIDIA 显卡（不支持 AMD GPU）
* **macOS 版本** ：需要 Apple Silicon 芯片
* **Linux** ：暂不支持
⚠️
由于 ComfyUI Desktop 仍处于 Beta 状态，实际的安装过程可能会发生变化。
## 下载地址
* 官网入口：
* 源码仓库：
有任何问题请在 [官方论坛](https://forum.comfy.org/) 或 [GitHub Issues](https://github.com/Comfy-Org/desktop/issues) 反馈。
💡
反馈时请附带对应的 log 错误日志和界面截图，便于官方更好地定位问题。在反馈前建议先搜索论坛内容，查看是否已有类似问题的解决方案。
## 安装教程
### 下载安装包
WindowsmacOS
**Windows 用户下载：**
* 下载链接：
* 适用于带有 NVIDIA 显卡的 Windows 系统
**macOS 用户下载：**
* 下载链接：
* 适用于 Apple Silicon 芯片的 Mac
也可通过 Homebrew 安装：
brew install comfyui
### 运行安装程序
WindowsmacOS
**Windows 安装步骤：**
1. 点击此处下载 [ComfyUI安装程序](https://download.comfy.org/windows/nsis/x64)
2. 下载完成后双击安装包进行安装
3. 安装完成后桌面会生成 ComfyUI Desktop 快捷方式
**macOS 安装步骤：**
1. 访问此处下载 [ComfyUI安装程序](https://download.comfy.org/mac/dmg/arm64)
2. 将 ComfyUI 图标拖入 Applications 文件夹
3. 如果图标显示禁止符号，说明系统版本不兼容 
### 首次启动与初始化
双击桌面快捷方式（Windows）或在 Launchpad 中找到 ComfyUI（macOS）启动程序。
首次启动会进入初始化设置流程：
#### 步骤 1：开始界面
点击 “Get Started” 开始初始化。
#### 步骤 2：选择 GPU 模式
WindowsmacOS
**Windows 用户可选择：**
* **NVIDIA 显卡** （推荐）：直接支持 PyTorch 和 CUDA
* **手动配置** ：需要手动安装 Python 环境
* **CPU 模式** ：仅适用于开发或特殊情况 
**macOS 用户可选择：**
* **MPS** （推荐）：Apple 的 Metal Performance Shaders，支持 GPU 加速
* **手动配置** ：需要手动安装 Python 环境
* **CPU 模式** ：仅适用于开发或特殊情况
#### 步骤 3：选择安装位置
选择 ComfyUI 相关内容的安装位置：
* Python 虚拟环境
* 模型文件
* 自定义节点
建议：
* 新建一个单独的空白文件夹作为安装目录
* 确保磁盘至少有 15GB 可用空间
* 选择 SSD 位置以提高性能
#### 步骤 4：迁移现有安装（可选）
如果你之前安装过 ComfyUI，可以选择迁移：
* 用户文件
* 模型文件（不会复制，只是建立关联）
* 自定义节点（会重新安装）
#### 步骤 5：桌面版设置
配置偏好设置：
* **自动更新** ：是否在有更新时自动更新
* **使用情况分析** ：是否收集匿名使用数据帮助改进
* **镜像设置** ：如果网络访问受限，可配置镜像
如果出现红色 ❌ 提示镜像失败，可以尝试以下镜像：
Python 安装镜像：
https://python-standalone.org/mirror/astral-sh/python-build-standalone
PyPI 镜像：
* 阿里云：
* 腾讯云：
* 中国科技大学：
### 完成安装
如果一切正常，安装程序将完成 Python 环境配置并自动进入 ComfyUI Desktop 界面。
### 进行第一次图像生成
安装完成后，你可以：
1. 加载默认工作流（workflow）
2. 下载所需的模型文件
3. 开始生成图像
💡
首次使用时可能需要下载模型文件，这可能需要一些时间，具体取决于你的网络速度。
## 添加外部模型路径
你可以在 ComfyUI 的菜单中添加外部模型来链接你本地的模型文件
通过上图的模式可以打开 `extra_model_paths.yaml` 文件添加外部模型路径：
* **Windows** ：`C:Users<你的用户名>AppDataRoamingComfyUIextra_model_paths.yaml`
* **macOS** ：`~/Library/Application Support/ComfyUI/extra_model_paths.yaml`
## 更新 ComfyUI
目前 ComfyUI Desktop 仅支持自动更新，会在有可用更新的时候提示你进行下载和安装，你也可以手动检查更新：
1. 在设置中启用自动更新
2. 或在菜单中选择”检查更新”
## 卸载 ComfyUI Desktop
WindowsmacOS
**Windows 卸载方法：**
**简单卸载：** 在 Windows 设置中卸载程序，不会删除模型文件、自定义节点等。 
**完整卸载：** 除了卸载程序，还需手动删除：
* `C:Users<你的用户名>AppDataLocal@comfyorgcomfyui-electron-updater`
* `C:Users<你的用户名>AppDataLocalPrograms@comfyorgcomfyui-electron`
* `C:Users<你的用户名>AppDataRoamingComfyUI`
**macOS 卸载方法：**
**简单卸载：** 在 Applications 文件夹删除 ComfyUI，不会删除模型文件、自定义节点等。
**完整卸载：** 除了删除应用程序，还需手动删除：
* `~/Library/Application Support/ComfyUI`
💡
如果删除了安装目录，模型、自定义节点、输入输出文件也将被删除。
## 故障排除
### 网络连接问题
如果安装过程中遇到网络问题：
1. 检查网络连接
2. 尝试使用 VPN
3. 配置镜像设置
### 设备不支持
如果显示设备不支持：
* Windows：确保有 NVIDIA 显卡
* macOS：确保是 Apple Silicon 芯片
### 获取帮助
如果遇到其他问题：
WindowsmacOS
**Windows 用户：** 查看日志文件：`C:Users<你的用户名>AppDataRoamingComfyUIlogs`
**macOS 用户：** 查看日志文件：`~/Library/Logs/ComfyUI`
**获取支持：**
1. 访问 [官方论坛](https://forum.comfy.org/) 寻求帮助
2. 在 [GitHub](https://github.com/Comfy-Org/desktop/issues) 提交问题报告
**提交问题时请包含：**
* 错误日志
* 系统信息
* 详细的错误描述
* 复现步骤
[1. 安装 ComfyUI](/zh/install/install-comfyui "1. 安装 ComfyUI")[1.2 Windows](/zh/install/install-comfyui/install-comfyui-on-windows "1.2 Windows")
主题授权提示：请在后台主题设置-主题授权-激活主题的正版授权，授权购买：RiTheme官网
