Homebrew安装失败时应优先校准系统时间，再用中科大镜像源安装；开发工具需确保Homebrew路径前置PATH；多版本语言环境须配合pyenv/nvm/rustup；卸载后需手动清理PATH和hash缓存。
Homebrew 安装失败：curl 证书或网络超时怎么办
Mac 上执行 brew install 前必须先装 Homebrew，而官方一键脚本依赖 curl 从 GitHub 拉取安装器。常见失败是证书验证失败（curl: (60) SSL certificate problem）或国内网络超时。
- 先确认系统时间准确，错误时间会导致 TLS 握手失败
- 临时绕过证书校验不推荐，更稳妥的是换镜像源安装：运行
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/brew-install/install.sh)" - 若提示
command not found: brew，检查~/.brew/bin或/opt/homebrew/bin是否在$PATH中；Apple Silicon Mac 默认路径是/opt/homebrew/bin，Intel 是/usr/local/bin
安装开发工具链：clang、git、make 等不在默认 PATH 怎么办
Homebrew 安装的命令行工具（如 git、make、cmake）默认不覆盖系统自带版本，但 macOS 自带的 make 或 python 往往太旧或缺失关键模块。关键不是“装没装”，而是“用不用得上”。
- 安装后运行
brew install git cmake make coreutils，其中coreutils提供 GNU 版本的ls、grep等，避免 BSD 和 GNU 行为差异引发脚本错误 - 检查是否生效：运行
which git，应返回/opt/homebrew/bin/git（Apple Silicon）或/usr/local/bin/git（Intel）；若仍指向/usr/bin/git，说明$PATH未前置 Homebrew 路径 - 在
~/.zshrc（macOS Catalina 及以后默认 shell）中添加：export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/bin:$PATH"（Intel），然后source ~/.zshrc
管理多版本语言环境：Python / Node.js / Rust 版本冲突怎么解
Homebrew 本身不原生支持多版本共存（如 python@3.11 和 python@3.12 同时安装），直接 brew install python 永远只保留最新稳定版软链到 python3。真要切换版本，得靠外部工具协同。
- Python 推荐用
pyenv：先brew install pyenv，再pyenv install 3.11.9 && pyenv install 3.12.4 && pyenv global 3.12.4；它会自动修改PATH并接管python命令 - Node.js 用
nvm（非 Homebrew 官方包）：运行curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash，之后nvm install 20 && nvm use 20 - Rust 不需要多版本管理工具：直接
brew install rustup，然后rustup install stable && rustup default stable；rustup自带工具链隔离能力 - 切记：不要用
brew link --force python强制覆盖系统链接，可能破坏 Xcode CLI 工具依赖
卸载和清理残留：brew uninstall 后命令还在 PATH 里
brew uninstall 只删包本身，不会自动清理 PATH 中曾被添加的路径，也不会删除用户手动创建的符号链接或配置文件。最典型的是卸载 node 后，which node 仍返回旧路径。
- 先查实际位置：
ls -l $(which node)，看是否指向/opt/homebrew/bin/node；如果是，说明brew uninstall node成功，但 shell 缓存了旧结果，运行hash -d node清除 hash 表 - 检查
~/.zshrc或/opt/homebrew/etc/profile.d下是否有残留的export PATH=...行 - 彻底清理 Homebrew：用
brew bundle dump --file=- | grep -v "^#"`查当前已装包列表，再brew uninstall --force $(brew list)；但注意这会连brew自身一起删，需重装
Homebrew 的核心价值不在“装软件”，而在提供统一、可复现、可审计的 CLI 工具分发渠道。真正容易被忽略的是 PATH 加载顺序、shell 初始化文件的加载时机，以及不同工具链（如 pyenv + brew Python）之间的隐式耦合——这些细节不爆错，但会在 CI 构建、团队协作或重装系统时突然暴露。
