ytzxm如果你是 MacBook 用户，又经常在终端里折腾开发环境，homebrew 这个词应该不陌生。它是 macOS 上最主流的包管理工具，很多人直接叫它“mac 的应用商店”：想装命令行工具，一条 brew install 搞定；想装图形化 App，一条 brew install --cask 也能解决。可每次只要出现和 homebrew 相关的内容，评论区总能看到同一批问题：安装脚本跑一半断了怎么办？配置了国内镜像源还是慢？卸载完软件硬盘空间一点没变？这篇文章就是一份很直接的 FAQ 实操手册，从安装、配置、日常操作到卸载残留清理，把容易踩的坑一次性讲透。刚上手的新手可以照着走一遍，已经用了一段时间的老手也可以直接跳到第 4 节，看看有没有自己忽略的细节。
1. 安装 homebrew：别急着跑脚本，先搞清楚它在干什么
很多人第一次安装 homebrew，就是复制官网那行命令直接粘贴回车，然后盯着终端发呆。运气好两分钟装完，运气不好卡在某个下载步骤半小时没反应。想解决这些问题，先弄清楚这行命令到底做了什么，后面遇到报错才不会慌。
1.1 官方一键脚本的完整执行流程
官方安装命令长这样：
bash复制/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
这行命令的意思很直白：先用 curl 下载 install.sh，然后用 bash 执行。脚本本身会按顺序做几件事。
第一步，检查系统里有没有 Xcode Command Line Tools。这是 macOS 上编译软件的基础工具集，如果没有，系统会弹出安装窗口。你点了确认之后，它会在后台静默安装，这个过程可能持续几分钟，看起来像卡住了，其实是在下载。我见过不少人在这一步直接关掉终端，导致后面反复安装失败。
第二步，根据处理器架构决定 homebrew 的安装路径。Apple Silicon 芯片（M1/M2/M3 等）装到 /opt/homebrew，Intel 芯片装到 /usr/local。这个路径差异非常关键，后面很多 FAQ 都跟它有关。
第三步，下载 homebrew 本体仓库，创建相关目录结构。这一步依赖网络，也是国内用户最容易卡住的地方。
第四步，把 shell 环境配置写进配置文件。脚本执行完会提示你运行两行命令来完成配置，很多人忽略这个提示，于是出现 command not found: brew。
安装完成后，建议第一时间验证：
bash复制brew --version
能输出版本号，说明主体没问题。接着执行：
bash复制brew config
这条命令会输出 homebrew 的平台、前缀路径、HOMEBREW_* 环境变量等关键信息，是排查一切安装异常的起点。
1.2 网络不理想时的国内源补齐方案
如果你发现安装过程反复失败，下载速度极慢，或者 brew update 半天不结束，基本可以判断是默认源访问不稳定造成的。对于这种场景，比较稳妥的做法是配置国内镜像源。
这里要纠正一个常见误区：很多人以为配了 homebrew 源就完事了，其实 homebrew 依赖多个远程仓库，主程序本身是一个 git 仓库，软件索引和预编译包又是另一套体系，如果只配其中一部分，速度可能还是没有明显提升。
常用的国内镜像源包括清华 TUNA、中科大 USTC、阿里云。以清华源为例，把下面几行写入 ~/.zshrc（zsh 用户）或 ~/.bash_profile（bash 用户）：
bash复制export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
写完后执行：
bash复制source ~/.zshrc
brew update
这几个环境变量的作用可以这样理解：HOMEBREW_API_DOMAIN 负责软件元数据接口，HOMEBREW_BOTTLE_DOMAIN 负责预编译包下载地址，HOMEBREW_BREW_GIT_REMOTE 和 HOMEBREW_CORE_GIT_REMOTE 负责 git 仓库同步。四者配合，才能让安装和更新全程走国内地址。
提示：如果你已经用官方脚本装到一半或者装失败了，不要着急直接重试。建议先把安装残留处理掉，再配置好环境变量后重新执行官方脚本。硬着头皮重跑很容易遇到“目录已存在但不完整”的奇怪报错。