Homebrew核心是将命令行工具的安装、更新、卸载、版本切换统一为几条命令，提升操作可靠性与可复现性；安装前须先装Xcode命令行工具并确认shell类型，再执行官方脚本安装，最后配置环境变量并用brew --version和brew doctor验证。
mac 上用 homebrew 管理命令行工具，核心就是把安装、更新、卸载、版本切换这些事，从手动下载编译变成几条清晰的命令。它不改变工具本身，只让操作更可靠、可追溯、可复现。
安装前必须准备好的两件事
Homebrew 不是独立运行的，它依赖系统底层能力：
- 先装 Xcode 命令行工具：终端里运行 xcode-select --install，点弹窗“安装”，完成后执行 xcode-select -p，看到 /Library/Developer/CommandLineTools 就对了；
- 确认当前 shell 类型：运行 echo $SHELL，macOS Catalina（10.15）之后默认是 /bin/zsh，配置文件是 ~/.zshrc；老系统可能是 /bin/bash，对应 ~/.bash_profile。
安装 Homebrew 本身
打开终端，粘贴执行官方安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
输入管理员密码（无视觉反馈，输完直接回车），等待自动完成。安装成功后，终端会提示类似：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
复制这行命令回车执行，再运行 source ~/.zshrc 立即生效。最后用 brew --version 和 brew doctor 验证——输出版本号和 Your system is ready to brew. 即表示就绪。
用 brew install 装命令行工具
Homebrew 把这类软件叫 Formulae，全部预编译好，自动处理依赖并链接到系统 PATH：
- brew install git —— 装 Git，装完直接可用 git --version；
- brew install wget tree htop —— 一次性装多个；
- brew install openjdk@17 —— 安装特定版本（如 Java 17），这类常被标记为 keg-only，需按提示手动加 PATH 才能全局调用；
- brew reinstall node —— 强制重装，适合修复损坏或覆盖旧版。
日常维护与版本管理
命令行工具不是装完就完事，后续维护同样靠 brew 统一收口：
- brew update —— 更新本地软件包列表（相当于刷新 App Store 的应用清单）；
- brew upgrade —— 升级所有已安装的 formula，也可指定 brew upgrade git；
- brew list —— 查看所有已装软件；brew leaves 则只显示你主动装的顶层工具（排除依赖包）；
- brew uninstall curl —— 卸载干净，不留缓存或配置残留；
- brew search ffmpeg —— 模糊查找，支持关键词，比如搜 ffmpeg 会列出 ffmpeg、ffmpeg@6 等可选版本。
遇到问题怎么快速定位
Homebrew 自带诊断机制，不用猜：
- brew doctor 是第一道检查：提示缺失工具、PATH 异常、权限问题等；
- brew config 显示当前环境信息（芯片架构、Homebrew 路径、shell 类型），方便判断是否走对路径（Apple Silicon 默认在 /opt/homebrew，Intel 在 /usr/local）；
- 如果某次 brew install 失败，错误信息里通常带具体包名和失败原因，比如 openssl 编译失败，大概率是 Xcode 工具没装全，重跑 xcode-select --install 再试。
