TopOff 怎么只更新一个 Homebrew 软件包？v2.2 操作指南

教程目标

在 TopOff 中检查 Homebrew 过期项目，并只对选中的单个软件包执行更新；当菜单只显示部分项目时，打开完整清单再选择。本文重点说明更新范围和可能影响，避免误把“Update All”当成单项操作。

适用环境

适用于 TopOff v2.2、macOS 14 或更高版本，且本机已安装 Homebrew。步骤根据 TopOff 官方 README 与 v2.2 发布说明整理；本次未安装或实测应用，菜单状态及文案可能随版本变化。

准备工作

1. 确认正在使用的 Mac 满足 macOS 14+ 要求。
2. 确认 Homebrew 已安装且可正常使用。TopOff 是 Homebrew 的图形界面，不包含独立软件仓库。
3. 先保存正在编辑的文件。Homebrew 更新会替换相应软件包版本；如更新的是正在使用的命令行工具，完成后可能需要重新打开终端或相关应用。
4. 若某些 cask 应用由自身更新器维护，先决定是否让 Homebrew 接管它们；不要为了看到更多项目就默认开启 Greedy。

查看清单并更新单个项目

1. 启动 TopOff，点击 macOS 菜单栏中的 TopOff 图标，查看它列出的过期 Homebrew 软件包。
2. 在清单中找到目标软件包，选择该项目对应的更新操作。TopOff 官方 README 将逐项更新与 Update All 作为不同操作；若当前菜单提供单项更新，确认所选行的包名后再执行。
3. 如果过期项目超过五个，v2.2 会在菜单末尾显示 Show All（例如 “Show All 8 Packages…”）。选择它打开完整的 Outdated Packages 窗口。
4. 在完整清单中核对包名和版本变化，只对目标行选择更新；需要暂缓的项目可选择跳过。不要点击窗口底部的 Update All，它会对所有可更新项目执行更新。
5. 等待更新完成，再回到 TopOff 检查该项目是否不再列为过期项。若仍显示旧状态，可按应用提供的手动检查选项重新检查。

预期结果

只选中的 Homebrew 包进入更新流程，其它项目保持未处理或跳过状态。TopOff 的 v2.2 发布说明称，完整清单会显示包名和版本变化，并支持逐项更新或跳过。最终安装版本取决于 Homebrew 当前可用的软件源和该包的发布状态。

常见问题与恢复

菜单里只看到几个软件包，怎样找完整列表？

当过期包超过五个时，v2.2 菜单会提供 Show All 入口；打开后在完整清单中逐项处理。五个及以下的呈现方式以当前应用界面为准。

我不想更新列表中的全部项目

在目标行选择单项更新，不要使用 Update All。执行前再次检查包名；若无法确认某项对应的操作，先关闭清单并查阅官方 README，不要猜测按钮含义。

Update 后应用仍显示旧的过期状态

用 TopOff 的手动检查选项重新检查。若更新本身失败，查看 TopOff 显示的结果，并通过 Homebrew 官方文档排查包管理问题；不要连续重复执行更新，以免忽略第一次操作的错误信息。

Greedy 要不要打开？

通常只有希望 Homebrew 同时管理默认会跳过的自动更新型 cask 时才考虑启用。若希望这些应用由各自的更新器维护，保持 Greedy 关闭。不同包的更新机制不同，设置前可查看 README 对 Update All 与 Greedy 的解释。

来源与核验范围

• TopOff 官方 README（功能、单项更新、Update All、Greedy、手动检查）：https://github.com/ihazgithub/TopOff
• TopOff v2.2 发布说明（Show All 与完整清单）：https://github.com/ihazgithub/TopOff/releases/tag/v2.2
• 核验日期：2026-10-17（Asia/Shanghai）。按官方文档整理，未实机测试更新行为。