名称： homebrew
描述： macOS 的 Homebrew 包管理器。用于搜索、安装、管理和排查软件包及 Cask 应用。
元数据： {"clawdbot":{"emoji":"🍺","requires":{"bins":["brew"]}}}

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 FORMULA|CASK...

用途： 安装一个或多个软件包或应用程序
使用时机： 当用户说“安装 X”或“用 brew 安装 X”时
说明：
- FORMULA = 命令行工具（安装到 /usr/local/bin）
- CASK = 图形界面应用程序（安装到 /Applications）
- 可同时安装多个：brew install git python nodejs
示例：

brew install python
brew install google-chrome  # 作为 cask 安装
brew install git python nodejs

brew update

用途： 获取 Homebrew 及所有公式的最新版本信息
使用时机： 当 brew 版本过旧或进行重要操作前
说明： 仅更新软件包列表，不升级软件包本身
示例：

brew update

brew upgrade [FORMULA|CASK...]

用途： 升级已安装的软件包或指定软件包
使用时机： 当用户需要更新到新版本时
说明：
- 无参数：升级所有过时的软件包
- 带参数：仅升级指定的软件包
示例：

brew upgrade              # 升级所有过时的软件包
brew upgrade python       # 仅升级 python
brew upgrade python git   # 升级多个软件包

软件包管理

brew uninstall FORMULA|CASK...

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

brew uninstall python
brew uninstall google-chrome

brew list [FORMULA|CASK...]

用途： 列出已安装的软件包或指定软件包的文件
使用时机： 当用户需要查看已安装内容或软件包包含的文件时
示例：

brew list                 # 显示所有已安装的软件包
brew list python          # 显示 python 安装的文件

配置与故障排除

brew config

用途： 显示 Homebrew 配置与环境信息
使用时机： 调试安装问题或检查系统设置
显示内容：
- 安装路径
- Xcode 位置
- Git 版本
- CPU 架构
示例：

brew config

brew doctor

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

brew doctor

brew install --verbose --debug FORMULA|CASK

用途： 以详细输出和调试信息模式安装
使用时机： 标准安装失败，需要详细错误信息时
示例：

brew install --verbose --debug python

高级用法

brew create URL [--no-fetch]

用途： 从源代码创建新公式
使用时机： 创建自定义软件包（高级用户）
选项：
- --no-fetch = 不立即下载源代码
示例：

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

brew edit [FORMULA|CASK...]

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

brew edit python

brew commands

用途： 显示所有可用的 brew 命令
使用时机： 了解额外的 brew 功能
示例：

brew commands

brew help [COMMAND]

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

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