Homebrew 国内镜像环境构建指南
1. 理解 Homebrew 与镜像源：为什么官方源在国内这么慢？
在开始动手之前，我们先花点时间搞清楚问题的根源。Homebrew 本质上是一个基于 Git 的包管理器，它通过从 GitHub 仓库拉取'配方'（formulae）和'木桶'（bottles）来安装软件。这里的'配方'是指构建软件的脚本，而'木桶'则是预编译好的二进制包，直接下载就能运行，无需本地编译。
当你在终端输入 brew install node 时，Homebrew 会做以下几件事：
- 从
homebrew-core仓库查找 node 的配方定义 - 从 GitHub 下载配方文件
- 检查是否有对应你系统版本的预编译二进制包（bottle）
- 从 GitHub 或 Bintray 下载二进制包
- 在本地执行安装
问题就出在第 2 步和第 4 步。GitHub 的服务器主要位于海外，对于国内用户来说，直接访问不仅速度慢，还经常因为网络波动导致连接中断。更糟糕的是，如果某个软件没有预编译包，Homebrew 会尝试从源码编译，这可能需要下载更多的依赖，失败的概率更高。
国内镜像源就是为了解决这个问题而生的。它们定时同步 GitHub 上的 Homebrew 仓库和二进制包，在国内部署服务器，让你能够以更快的速度、更稳定的连接获取所需内容。目前主流的镜像源有：
| 镜像源 | 维护机构 | 主要特点 | 适用场景 |
|---|---|---|---|
| 清华大学 TUNA | 清华大学开源软件镜像站 | 同步及时，文档完善，社区活跃 | 大多数用户的首选，稳定性好 |
| 中科大 USTC | 中国科学技术大学开源软件镜像站 | 历史悠久，镜像全面 | 教育网用户访问速度极佳 |
| 阿里云 | 阿里巴巴集团 | 商业运营，带宽充足 | 对下载速度有极致要求的用户 |
提示：虽然这些镜像源都提供类似的服务，但它们的同步频率、可用性和访问速度可能因你的地理位置和网络运营商而异。我个人的经验是，在教育网环境下中科大源表现最佳，而普通宽带用户使用清华或阿里云源通常都能获得满意的速度。
理解了这些背景，我们就能明白，配置国内镜像不是'可选项'，而是国内 Mac 开发者的'必选项'。接下来，我们就从最基础的安装开始。
2. 从零开始：为全新 Mac 安装 Homebrew 并配置镜像
如果你手上的 Mac 还没有安装 Homebrew，或者打算彻底重装，那么这一节就是为你准备的。我们将采用手动安装 + 环境变量配置的方式，这种方法虽然步骤稍多，但能让你对整个过程有完全的控制权，也更容易排查问题。
2.1 安装前的准备工作
在运行任何安装命令之前，确保你的系统已经安装了必要的命令行工具。打开终端（Terminal），首先检查是否已安装 Command Line Tools：
xcode-select --install
如果系统提示'command line tools are already installed'，那么你可以跳过这一步。否则，会弹出一个安装对话框，按照提示完成安装即可。这个过程可能需要下载大约 1-2GB 的数据，所以请确保网络连接稳定。
注意：即使你已经安装了 Xcode 的完整版，也建议单独安装 Command Line Tools。完整版 Xcode 体积巨大，而 Command Line Tools 只包含编译器等必要组件，对于大多数开发任务来说已经足够。
接下来，我们需要决定使用哪个镜像源。为了便于说明，我将以清华大学镜像源为例，但你可以根据自己的偏好替换为其他源。首先，我们设置临时的环境变量，这些变量会在当前终端会话中生效，指导 Homebrew 从镜像源安装：
# 设置从 API 安装（Homebrew 4.0+ 的默认行为，兼容性更好）
export HOMEBREW_INSTALL_FROM_API=1
# 设置核心仓库的镜像地址
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"
# 设置二进制包和 API 的镜像地址
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-api"
