homebrew

用途

Homebrew 是 macOS 上的包管理器。本技能提供完整的 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...：安装一个或多个软件包或应用。FORMULA 指命令行工具（安装到 /usr/local/bin），CASK 指图形界面应用（安装到 /Applications）。可一次安装多个，如 brew install git python nodejs。示例：brew install python、brew install google-chrome（作为 cask 安装）。
brew update：获取 Homebrew 及所有 formula 的最新版本。不会升级软件包，只更新软件包列表。
brew upgrade [FORMULA|CASK...]：升级已安装的软件包或指定软件包。不带参数时升级所有过时软件包；带参数时只升级指定软件包。示例：brew upgrade、brew upgrade 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。

brew config：显示 Homebrew 配置与环境信息，用于调试安装问题或检查系统设置。显示内容包括安装路径、Xcode 位置、Git 版本、CPU 架构。
brew doctor：检查 Homebrew 安装的潜在问题，返回警告和修复建议。
brew install --verbose --debug FORMULA|CASK：带详细输出和调试信息进行安装，适用于标准安装失败、需要详细错误信息时。示例：brew install --verbose --debug python。

brew create URL [--no-fetch]：从源代码创建新的 formula，供高级用户创建自定义软件包。--no-fetch 表示不立即下载源代码。示例：brew create https://example.com/package.tar.gz。
brew edit [FORMULA|CASK...]：编辑 formula 或 cask 定义，供高级用户自定义软件包安装。示例：brew edit python。
brew commands：显示所有可用的 brew 命令。
brew help [COMMAND]：获取特定命令的帮助。示例：brew help install、brew help upgrade。

安装新软件包：搜索（brew search python）→ 获取信息（brew info python@3.11）→ 安装（brew install python@3.11）。

排查安装问题：检查配置（brew config）→ 运行 doctor（brew doctor）→ 带调试重试（brew install --verbose --debug FORMULA）。

维护 Homebrew：更新（brew update）→ 查看过时项（brew upgrade 会显示将要升级的内容）→ 全部升级（brew upgrade）。

适用于 macOS 用户通过命令行安装、更新、卸载和排查软件包与图形界面应用，也适用于需要查看软件包依赖信息、维护 Homebrew 环境或创建自定义 formula 的场景。