Homebrew 是 macOS 上最常用的包管理器之一。把软件安装和版本管理交给它，你可以用一份清单快速复刻环境：重装系统、换新电脑、或团队新人入职都很省心。
工具地址：https://brew.sh/（官网）
建议先安装 Xcode Command Line Tools，否则后续编译依赖可能失败。你可以在终端执行：
xcode-select --install
安装完成后，建议确认开发者目录是否正确：
xcode-select -p
如果公司网络有代理或不稳定，优先保证访问 GitHub 与 Homebrew 相关域名稳定；遇到下载缓慢时，先排除 DNS/代理配置问题，再考虑更换网络。
Homebrew 官网提供了安装脚本。安装完成后，第一件事建议做健康检查与更新：
brew doctor
brew update
如果提示 PATH 未配置，按提示把 brew 的 bin 路径加入你的 shell 配置（如 ~/.zshrc），然后重新打开终端或执行 source ~/.zshrc。
下面是一份偏通用的安装组合（示例）。建议先分批安装，便于定位某个包导致的问题：
brew install git wget curl jq yq ripgrep fzf htop tree
brew install node python@3.12
如果你经常处理图片/视频或文档，可以按需加上：
brew install ffmpeg imagemagick poppler
提示：某些包会依赖系统组件或额外的编译工具。出现编译失败时，优先查看报错末尾的“缺什么”，再回头补齐依赖。
当你把常用工具装齐后，可以导出一份 Brewfile，未来在新机器上直接一键恢复：
brew bundle dump --file=~/Brewfile --force
在新机器上恢复时：
brew bundle --file=~/Brewfile
这种方式很适合团队协作：把 Brewfile 放进项目或内部文档，大家的基础工具版本更一致。
PATH 不生效：确认你使用的 shell（zsh/bash），以及配置文件是否正确加载；必要时重启终端。
权限相关报错：不要用不明来源的脚本提升权限。按 Homebrew 的提示修复目录权限，或检查是否存在历史残留目录。
版本冲突：尽量避免手动在多个位置安装同名工具（例如同时用安装包与 brew 安装）。优先保留一种来源，并在终端中用 which / type -a 确认实际生效路径。
