Homebrew 是 macOS 上最常用的软件包管理器之一。它可以让你用一条命令安装/更新/卸载开发工具、命令行小工具、以及大量 GUI 应用（cask）。本教程按“照着做就能成功”的方式，覆盖：
1）确认系统与芯片类型
点击左上角 → 关于本机。你会看到“芯片（Apple）”或“处理器（Intel）”。这会影响 Homebrew 默认安装目录：
2）安装 Xcode Command Line Tools
Homebrew 依赖编译工具链。打开“终端”，执行：
xcode-select --install弹窗出现后按提示安装即可。安装完成后可用下面命令检查：
xcode-select -p能输出路径（例如 /Library/Developer/CommandLineTools）就说明准备OK。
建议使用官方安装脚本。打开终端，复制执行（官方会提示你输入管理员密码）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后必须做一步：把 brew 写入 PATH（非常关键）
很多人“装完找不到 brew”，本质是 PATH 没配置。按你的芯片类型执行对应命令：
Apple Silicon（/opt/homebrew）
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)"Intel（/usr/local）
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile eval "$(/usr/local/bin/brew shellenv)"然后验证：
brew -v brew doctorbrew doctor 如果有警告先别慌，后面有排查。
Homebrew 的“慢”通常来自两个环节：索引拉取（Git / API）与瓶装包下载（bottle）。你可以按以下顺序排查：
1）先判断是“解析慢”还是“下载慢”
2）优先用“镜像源”加速（不涉及破解/绕过付费）
很多网络环境下，配置镜像源可以显著加速（具体镜像地址以你所在网络可用为准；建议选择可信的高校/云厂商镜像，并阅读其说明）。一般思路是设置以下环境变量（示例）：
做法通常是把变量写入 shell 配置（例如 ~/.zshrc 或 ~/.zprofile），然后重新打开终端生效。
3）如果你本来就有合规代理/公司网络，确保终端也走代理
浏览器能上不代表终端能上。你可以检查终端是否设置了 http_proxy/https_proxy 等变量；必要时按你自己的合规网络策略配置。
Q1：提示“xcode-select: error: command line tools are already installed”但仍失败
Q2：装完后提示“command not found: brew”
Q3：权限错误 / 目录不可写（Permission denied）
Q4：卡在更新或下载，反复超时
Q5：brew doctor 一堆 warning 要不要管？
如果你只想卸载某个包：
brew uninstall 包名 brew cleanup如果你确定要卸载 Homebrew 本身，可使用官方卸载脚本（注意会删除 Homebrew 目录与已安装包）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
