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 数据位置