Brew 历史版本安装

要解决什么问题

日常用 brew install 装到的往往是 formula 当前指向的版本。项目锁在旧版编译器、数据库客户端或图形库时，直接升级可能破坏构建；而 Homebrew 官方并不提供「brew install foo@1.2.3」这类历史版本通道。你需要的是：从 homebrew-core 的 Git 历史里取出某一时刻的 .rb formula，再让 brew 按那份定义安装。

技能如何工作

本技能把上述流程拆成可执行的检查与操作顺序，避免在「已装同版本」「已装不同版本」等状态下重复或冲突安装。

核心原理：每个包的 formula 都在 homebrew-core 仓库的 Formula/<首字母>/<包名>.rb；任意历史版本对应某次 commit 上的文件内容。

关键步骤概览：

• 前置检查：确认 brew 可用；用 brew list --versions 判断目标包是否已安装、版本是否已是目标版本（相同则直接结束）。
• 定位 formula：brew info <包名> 记下 From: 路径。
• 在 GitHub 选版本：打开对应 .rb 的 History，按版本号找到 commit，用 Browse code 拿到该提交的原始文件 URL。
• 安装：brew install <本地下载的.rb> 或 brew install <原始文件 URL>。

技能文档中还包含卸载冲突版本、--ignore-dependencies 时的依赖风险提示，以及按包名首字母拼 URL 的示例（如 qt → Formula/q/qt.rb）。

适用边界与注意点

• History 按时间排序，对照版本号找 commit 可能需要翻页；部分包已从仓库移除则无法再用此法安装。
• 同一 formula 不能多版本并存；换版本通常要先 brew uninstall。
• 旧 formula 可能拉起与当前系统不兼容的依赖，安装失败时需按 brew 提示单独处理。
• 权限类错误多与 Homebrew 目录归属或 PATH 有关，需先修好本机 brew 环境再重试。