Homebrew 包管理器

完整的 Homebrew 命令参考和使用指南，用于安装、管理和排查 macOS 软件包问题。

使用时机

• 安装软件包或应用程序 (brew install X)
• 搜索可用的软件包 (brew search X)
• 更新和升级已安装的软件包
• 检查软件包信息和依赖项
• 排查安装问题
• 管理已安装的软件包

命令参考

软件包搜索与信息

brew search TEXT|/REGEX/

用法：通过名称或正则表达式模式查找软件包使用时机：当用户要求查找或搜索软件包时示例：

brew search python
brew search /^node/

brew info [FORMULA|CASK...]

使用方法：显示一个或多个软件包的详细信息使用时机：安装前查看依赖项、选项和详细信息示例：

brew info python
brew info chrome google-chrome

安装与升级

brew install 公式|桶装应用...

使用方法：安装一个或多个软件包或应用程序使用时机：当用户说“安装X”或“用brew安装X”时注意事项：

• 公式 = 命令行工具（安装到 /usr/local/bin）
• 桶装应用 = 图形界面应用程序（安装到 /Applications）
• 可一次性安装多个：brew install git python nodejs 示例：

brew install python
brew install google-chrome  # installs as cask
brew install git python nodejs

brew update

使用方法：获取Homebrew及其所有公式的最新版本使用时机：当brew似乎过时或在进行重大操作之前说明：不升级软件包，仅更新软件包列表示例：

brew update

brew upgrade [FORMULA|CASK...]

用法：升级已安装的软件包或特定软件包使用时机：当用户希望更新到新版本时说明：

• 无参数：升级所有过时的软件包
• 带参数：仅升级指定的软件包示例：

brew upgrade              # upgrade all outdated packages
brew upgrade python       # upgrade just python
brew upgrade python git   # upgrade multiple

软件包管理

brew uninstall FORMULA|CASK...

用法：移除已安装的软件包使用时机：当用户想要移除/删除一个软件包时说明：可以同时卸载多个软件包示例：

brew uninstall python
brew uninstall google-chrome

brew list [FORMULA|CASK...]

用法：列出已安装的包或指定包包含的文件使用时机：当用户想查看已安装内容或某个包包含哪些文件时示例：

brew list                 # show all installed packages
brew list python          # show files installed by python

配置与故障排除

brew config

用法：显示 Homebrew 的配置和环境信息使用时机：调试安装问题或检查系统设置时显示内容：

• 安装路径
• Xcode 位置
• Git 版本
• CPU 架构示例：

brew config

brew doctor

用法：检查 Homebrew 安装的潜在问题使用时机：当遇到安装问题或错误时返回：警告和修复问题的建议示例：

brew doctor

brew install --verbose --debug 公式|木桶

用法：安装时输出详细信息及调试信息何时使用：当标准安装失败且需要详细的错误信息时示例：

brew install --verbose --debug python

高级用法

brew create 网址 [--no-fetch]

用法：从源代码创建新公式何时使用：创建自定义软件包（高级用户）选项：

• --no-fetch= 不立即下载源代码示例：

brew create https://example.com/package.tar.gz

brew edit [公式|木桶...]

用法：编辑公式或cask定义何时使用：自定义软件包安装（高级用户）示例：

brew edit python

brew命令

用法：显示所有可用的brew命令何时使用：了解其他brew功能示例：

brew commands

brew help [命令]

用法：获取特定命令的帮助何时使用：需要特定命令的详细帮助示例：

brew help install
brew help upgrade

快速参考

常用工作流程

安装新软件包

1. 搜索：brew search python
2. 获取信息：brew info python@3.11
3. 安装：brew install python@3.11

安装故障排查

1. 检查配置：brew config
2. 运行诊断：brew doctor
3. 调试模式重试：brew install --verbose --debug FORMULA

维护 Homebrew

1. 更新：brew update
2. 检查过时项目：brew upgrade（显示可升级项目）
3. 全部升级：brew upgrade

核心概念

FORMULA（配方）：命令行工具与库（如 python、git、node）CASK（木桶）：图形界面应用程序（如 google-chrome、vscode、slack）TAP（第三方源）：第三方配方仓库（例如：brew tap homebrew/cask-versions）

注意事项

• 所有brew命令都需要先安装Homebrew
• 从源码构建需要Xcode命令行工具
• 某些包可能会要求输入sudo密码
• 不同包的安装时间各不相同
• 包名称不区分大小写，但按惯例显示为小写

资源

• 官方文档：https://docs.brew.sh
• 公式文档：https://github.com/Homebrew/homebrew-core
• Cask文档：https://github.com/Homebrew/homebrew-cask