ComfyUI Desktop 在 macOS 安装与首次启动教程

双击安装包后看到 Comfy Desktop 图标，说实话，这离真正能用上 ComfyUI 还差得远。macOS 端的安装其实分两段走：先把桌面启动器拖进 Applications，再由它去创建第一个 ComfyUI 实例，顺便把 Python 环境和依赖都准备好。什么时候模板库出现在工作区里了，才算真正走通了首次启动。

先确认这台 Mac 能运行 Comfy Desktop

目前 Comfy Desktop for macOS 只支持 Apple Silicon，系统版本得是 macOS 13 Ventura 或更高。点屏幕左上角的苹果菜单，进“关于本机”，在“芯片”那一栏确认写着 Apple M1、M2、M3、M4 或更新的型号。如果显示的是 Intel，那这个桌面版本就不适用，别继续拿着同一个安装包反复试了，没用的。

每个独立的 ComfyUI 实例至少需要预留大约 4.85 GB 的磁盘空间；官方给出的内存下限是 8 GB，推荐 16 GB。模型文件通常比程序本身大得多，如果打算长期用，记得在“系统设置 > 通用 > 存储空间”里再留出模型和输出图片的空间。磁盘余量不足，环境安装会停在中途——就算桌面应用本身能打开，后面也跑不起来。

从官方页面取得 macOS 安装包

1. 入口位置：
   在浏览器打开 ComfyUI 官方下载页。

   主要动作：
   让页面识别当前平台，选择 macOS 下载，等待扩展名为 .dmg 的文件进入“下载”文件夹。

   成功标志：
   浏览器下载列表显示文件传输结束，Finder 中能看到 DMG 文件。

   失败处理：
   页面如果没给出 macOS 选项，先回“关于本机”核对芯片和系统版本；别从不明来源下载压缩包，Intel Mac 换哪个下载地址都不会兼容。

2. 入口位置：
   在 Finder 的“下载”文件夹中双击 DMG。

   主要动作：
   等磁盘映像窗口出现后，把左侧的 Comfy Desktop.app 拖到右侧 Applications 文件夹。

   成功标志：
   复制进度结束，Finder 的“应用程序”里出现 Comfy Desktop。

   失败处理：
   如果提示没有权限，确认当前账户能向 Applications 写入；公司管理的 Mac 可能需要找管理员批准。

第一次打开时处理 macOS 安全提示

3. 入口位置：
   从 Launchpad、Spotlight 或 Finder 的“应用程序”打开 Comfy Desktop。

   主要动作：
   如果 macOS 弹出安全警告，进“系统设置 > 隐私与安全性”，在对应拦截信息旁边点“仍要打开”，再确认一次。

   成功标志：
   Comfy Desktop 窗口出现，而不是每次启动都回到安全拦截框。

   失败处理：
   “仍要打开”只会在刚刚尝试启动后出现；看不到的话，先回“应用程序”再打开一次。受组织策略管理的设备可能没有放行权限，需要设备管理员处理。

4. 入口位置：
   进入 Comfy Desktop 的 Chooser 首页，找到左上区域的“+ New Install”。

   主要动作：
   新建一个 Standalone 实例，不要把 Remote Connection 当成本机首次安装。

   成功标志：
   窗口切换到“Configure Comfy Desktop”配置页。

   失败处理：
   如果首页只有旧实例卡片，仍然可以用“+ New Install”；如果是从 Legacy Desktop 迁移过来的，应该先决定是否采用官方迁移路径，避免把旧目录当成新空实例覆盖掉。

配置首个本地 ComfyUI 实例

5. 入口位置：
   在“Configure Comfy Desktop”页面查看 Name、Install Location、安装类型、Release 和 Hardware。

   主要动作：
   给实例填一个容易识别的名称；确认安装位置空间足够；保留推荐的 Standalone、Stable 和 Apple Silicon（MPS）选项，然后点 Continue。

   成功标志：
   硬件区域识别出 Apple Silicon，Continue 可点击，提交后进入安装进度页。

   失败处理：
   如果没有识别到 Apple Silicon，先停止安装并复核设备芯片；如果路径空间不足，点 Browse 改到有足够容量且当前账户可写入的位置。

等待程序准备 Python 环境和 ComfyUI

6. 入口位置：
   点 Continue 后出现安装进度页。

   主要动作：
   保持 Comfy Desktop 运行，让它下载 Python、创建环境并安装 ComfyUI；观察当前阶段、百分比、下载量、速度和预计剩余时间。

   成功标志：
   百分比持续增长，阶段文字会变化，结束后自动进入 ComfyUI 工作区或模板库。

   失败处理：
   短时间没有变化不一定是故障；如果长时间停在同一阶段且速度为零，先检查网络与磁盘余量。网络环境需要镜像时，可以在桌面设置的 Advanced 页面核对 Git 与 PyPI 镜像选项，再重新创建实例；不要在安装过程中强制删除正在写入的目录。

用模板库确认首次启动成功

7. 入口位置：
   环境安装结束后查看 ComfyUI 工作区中央的 Templates 窗口。

   主要动作：
   先确认左侧出现模板分类、右侧能加载模板卡片，再从 Getting Started 或适合当前硬件的分类选择工作流。

   成功标志：
   模板库、Graph 工作区和顶部 Run 控件同时可见，说明桌面启动器已经拉起首个 ComfyUI 实例。

   失败处理：
   如果只回到 Chooser 首页，点击刚创建的实例卡片重新启动；如果卡片出现错误标记，打开实例菜单的 Manage，再从 Console 查看后端启动日志，别仅凭空白工作区判断安装文件损坏。

离开安装页面前逐项确认

• “关于本机”显示 Apple Silicon，系统为 macOS 13 或更高版本。
• Comfy Desktop 位于 Applications，而不是一直从 DMG 临时窗口运行。
• 首个实例采用 Standalone，并识别为 Apple Silicon（MPS）。
• 安装进度正常结束，没有长期停在零速度或磁盘不足提示。
• 重新打开 Comfy Desktop 后，实例卡片可以启动，Templates 和 Graph 工作区能够出现。

后续下载模型或加入自定义节点前，先记住首个实例的安装位置。Comfy Desktop 默认把独立实例放在 ~/ComfyUI-Installs 这类目录中，应用设置、实例记录和日志则位于 ~/Library/Application Support/Comfy Desktop。排查启动失败时，先看 Manage 面板里的 Console 和这个日志目录，比重复删除应用更容易保留问题线索。

官方资料入口

1. Comfy Desktop macOS 安装与系统要求
2. Comfy Desktop 概览与硬件、空间、内存要求
3. 首个实例配置、安装进度与模板库
4. Manage 面板与 Console 排查入口
5. 桌面设置、镜像选项和 macOS 数据位置