ComfyPilotComfyPilot
文档 / 安装 / 适用于 macOS 的 Comfy Desktop

适用于 macOS 的 Comfy Desktop

在 macOS 上安装 Comfy Desktop：系统要求、安装步骤、更新，以及如何在 Apple 芯片 Mac 上彻底卸载并本地运行 ComfyUI。

安装 macos 更新于 2026-11-12

查看官方原文

适用于 macOS 的 Comfy Desktop

在 macOS 上安装 Comfy Desktop：系统要求、安装步骤、更新，以及如何在 Apple 芯片 Mac 上彻底卸载并本地运行 ComfyUI。

Comfy Desktop 是一个多实例管理器，让您从一个启动器运行多个 ComfyUI 实例。本指南介绍如何在 macOS 上安装和卸载 Comfy Desktop。

系统要求

  • 系统： macOS 13 (Ventura) 或更新版本
  • 硬件： Apple Silicon（M1 或更新）
  • 磁盘空间： 每个安装建议至少 4.85 GB
[card] 下载 Comfy Desktop 下载 macOS 最新安装程序。页面会自动检测您的平台。

安装

  1. 打开下载的 .dmg 文件
  2. 将 Comfy Desktop 拖入 Applications 文件夹
  3. 从 Launchpad 或 Spotlight 启动

Desktop MacOS

首次启动时，macOS 可能显示安全警告。前往系统设置 → 隐私与安全性，点击仍要打开以允许运行。

[!TIP] 已经在用 Legacy Desktop？ Comfy Desktop 可以自动检测并迁移你现有的安装。自定义节点、工作流、模型和设置都会一并纳入，Comfy Desktop 也会在开始前备份旧版状态。迁移会就地复用你现有的数据文件夹和 Python 环境，如果需要保留一份完整副本，请自行提前备份。 了解更多，请查阅从旧版迁移指南。
[card] 下一步：使用 Comfy Desktop 安装完成后，了解如何创建实例、管理安装和配置设置。

更新 Comfy Desktop

Comfy Desktop 启动后不久检查一次更新，运行期间每 10 分钟检查一次，而且每次检查都会下载找到的版本。两者都无法关闭。唯一的设置决定更新之后是否不经询问就安装。

自动更新

自动安装桌面端更新默认开启。标题栏会显示下载进度：先是 正在下载更新…，完成后是 桌面端更新已就绪。开启这个设置时，Comfy Desktop 会不经询问直接安装：macOS 上退出应用时安装，Windows 上在下次启动时安装。

如果想立刻重启，点击标题栏上的这个按钮：重启并更新 会退出 Comfy Desktop 并以新版本重新打开，应用里正在运行的内容也会一并关闭。稍后 只是关闭提示，更新仍会在之后自动应用——这种自动应用只在本开关开启时才会发生。

手动更新

  1. 点击 ☰，选择 桌面端设置。
  2. 打开 更新 标签页。

卡片先给出状态，例如 Comfy Desktop 已是最新 或 更新 v1.2.0 已准备好安装，接着是已安装的版本、上次检查时间，以及存在新版本时的最新版本。主按钮随状态变化：检查更新、下载 或 重启并更新。下载进行中时，点击标题栏上的按钮会打开桌面端设置，更新 标签页里能看到进度。

打开更新标签页的桌面端设置，显示已是最新状态、已安装版本和自动安装开关

关闭卡片下方的 自动安装桌面端更新 开关后，更新不会自行安装。标题栏显示 桌面端更新，更新卡片显示 有可用更新 …。文件仍会下载；就绪后点击 桌面端更新已就绪 并选择 重启并更新。

卸载

卸载 Comfy Desktop

  1. 在访达中打开 Applications 文件夹
  2. 右键点击 Comfy Desktop，选择 移到废纸篓

在 macOS 上卸载 Comfy Desktop

卸载应用不会删除的内容

卸载 Comfy Desktop 只会移除启动器本身。以下数据不会被删除，如需完全清理请手动删除：

数据默认位置说明
安装实例~/ComfyUI-Installs每个 ComfyUI 安装（也可在应用内删除）。自定义安装路径也不会被删除。
共享模型和输出~/ComfyUI-Shared共享模型库、输入/输出目录
应用设置和记录~/Library/Application Support/Comfy Desktop设置和安装记录
日志~/Library/Logs/Comfy Desktop桌面应用日志（app.log）
[!WARNING] 上述目录包含您的个人 ComfyUI 数据：模型、输出、设置和安装实例。它们不是 Comfy Desktop 应用程序文件。删除它们将永久移除您的数据。

要完全清除所有数据：

  1. 删除应用数据文件夹：~/Library/Application Support/Comfy Desktop
  2. 删除日志文件夹：~/Library/Logs/Comfy Desktop
  3. 从应用内删除单个安装，或手动删除 ~/ComfyUI-Installs 以及你配置过的自定义安装目录
  4. 删除共享模型库 ~/ComfyUI-Shared（仅当不再需要这些文件时）

应用启动后界面异常

手动更新后，Comfy Desktop 可能出现界面没有样式、翻译缺失，或按钮和下拉菜单点击无反应。常见原因是上一版本残留的 Chromium 配置文件或已缓存的待更新包。

请先退出 Comfy Desktop，然后运行 Comfy-Desktop 仓库里的重置脚本：

curl -fsSLO https://raw.githubusercontent.com/Comfy-Org/Comfy-Desktop/main/scripts/reset-mac.sh && bash reset-mac.sh

脚本会先列出将要删除的每个路径，确认后才删除。它清理当前版本以及早期应用名下的设置、缓存和 Chromium 配置文件，避免旧版本残留重新生效。Comfy Desktop 正在运行时，脚本会拒绝执行。日志文件夹也在删除范围内，如果需要反馈问题，请先复制日志，见应用日志在哪里。

~/ComfyUI-Installs 里的 ComfyUI 安装和 ~/ComfyUI-Shared 里的共享模型不会被删除，但记录安装列表的文件会随其他应用数据一起删除，下次启动时可能需要用 Add Existing Instance 重新添加。脚本还会列出它在 Mac 上找到的额外应用副本但不删除，因为 Dock 里同时存在旧副本，是“重置后依旧异常”的常见原因。

应用日志在哪里

如果重置没有解决问题，想把问题反馈到 Comfy-Desktop 的 issue 时，需要附上的文件是 ~/Library/Logs/Comfy Desktop 下的 app.log。这个文件夹也在重置的删除范围内，请先把它复制到别处再运行脚本。Comfy Desktop 每次启动都会新写一个 app.log，并把最近的 50 个旧文件以 app.log_<timestamp>.log 的名字保留在同一目录，请选出现问题那次会话的文件。单个文件达到 5 MB 后会切换到新文件，因此一次很长的会话可能分散在多个文件里。