Homebrew 安装失败主因是未安装 Xcode Command Line Tools，需先运行 xcode-select --install；再按芯片架构执行官方安装脚本；装完必须运行 brew doctor 排查环境问题。
brew install 装不上命令？先确认 Homebrew 是否真正就绪
很多人执行 brew install 报错，根本原因不是软件源问题，而是 Homebrew 自身没完成初始化。macOS 13+（Ventura 及更新）默认不带 Command Line Tools，而 brew 启动时依赖 git、curl 和编译工具链——这些全靠 Xcode Command Line Tools 提供。
实操建议：
- 先运行
xcode-select --install，弹窗点“安装”，等进度条结束（约 2–5 分钟） - 再验证：
which brew应返回/opt/homebrew/bin/brew（Apple Silicon）或/usr/local/bin/brew（Intel），若无输出，说明还没装 Homebrew，需跑官网脚本：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 装完立刻运行
brew doctor，它会指出 PATH 冲突、旧版 Xcode 占位、/usr/local 权限异常等真实拦路虎，别跳过
装开发工具别只盯 “热门列表”，按场景选对包名
比如搜“Mac 终端好用工具”，结果常堆出 htop、bat、exa，但实际需求更细：是查进程卡顿？还是替代 cat 看代码？或是替换 ls 显示颜色和图标？包名错一个字母就装错，甚至装到完全无关的同名软件（如 httpie ≠ https）。
常见场景对应推荐（已验证兼容 macOS 14 Sonoma + Apple Silicon）：
- 终端增强：
brew install zsh-syntax-highlighting zsh-autosuggestions（配合 Oh My Zsh，不是zsh-history-substring-search那种已弃用的老方案） - 网络调试：
brew install httpie jq wget（curl系统自带，无需重装；jq必须装，否则 JSON 解析只能靠 Python 临时凑） - 本地服务：
brew install nginx redis sqlite3（注意：不要装mysql，新版默认是mysql@8.0，启动命令和配置路径都不同） - 开发语言运行时：
brew install node python rust（python装的是最新稳定版，不是系统自带的 2.7；rust会自动带cargo，不用另装）
brew tap 是什么？为什么装 fzf、nvm 这类工具必须加它
brew tap 本质是第三方公式仓库的“订阅”。Homebrew 官方主仓（homebrew/core）不收维护成本高、版本迭代快或带交互逻辑的工具，比如模糊搜索神器 fzf、Node 版本管理器 nvm、Kubernetes 工具集 kubectx —— 它们由原作者自己维护在独立 tap 里。
典型操作流程：
- 先加源：
brew tap junegunn/fzf（不是brew tap add，后者不存在） - 再安装：
brew install fzf（此时才真从 junegunn 的仓库拉公式） - 装完别忘初始化：
/opt/homebrew/opt/fzf/install（路径随芯片架构变，用brew --prefix fzf查准） - 常见必须 tap 的组合：
brew tap homebrew/cask-versions（装旧版 Chrome、VS Code）、brew tap koekeishiya/formulae（装skhd键盘守护进程）
装完命令不生效？PATH 和 shell 初始化顺序才是关键
装完 node 或 rust 后，终端敲 node -v 报 “command not found”，大概率不是安装失败，而是 shell 没加载新 PATH。Apple Silicon Mac 默认 shell 是 zsh，但初始化文件有优先级：~/.zprofile > ~/.zshrc，而 Homebrew 建议把 PATH 加在 ~/.zprofile 里（因为登录 shell 先读它）。
检查与修复步骤：
- 运行
echo $PATH，看输出是否含/opt/homebrew/bin（M1/M2）或/usr/local/bin（Intel） - 若没有，打开
~/.zprofile，末尾加一行：export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/bin:$PATH"（Intel） - 保存后执行
source ~/.zprofile，再试命令 - 特别注意：VS Code 终端可能缓存旧 shell 环境，关掉所有窗口再重开；iTerm2 需在 Profiles → General → Shell 中勾选 “Login shell”
最易被忽略的一点：某些 cask 安装的 GUI 软件（如 brew install --cask visualstudiocode）会把命令行工具软链到 /opt/homebrew/bin/code，但前提是 VS Code 自身设置里已启用 “Shell Command: Install ‘code’ command in PATH” —— 这个开关藏在 Command Palette（Cmd+Shift+P）里，不手动点一次，终端永远找不到 code。
