Homebrew 换源

1. Homebrew 核心组件架构

Homebrew 并非一个单一仓库，它由以下三个核心模块解耦构成：

组件名称	核心职责
brew	Homebrew 工具本身的 Ruby/Bash 源代码引擎仓库。
homebrew-core	Homebrew 的核心软件配方仓库（包含数万个软件的编译/安装规则）。
homebrew-bottles	预编译好的二进制软件包容器（免去用户本地编译源码的漫长等待）。
(附加) homebrew-cask	用于安装具有图形界面 (GUI) 的大型 macOS 应用软件。

---

2. 极速环境配置：国内镜像源替换 (阿里云)

因默认 GitHub 节点问题，国内使用 brew update 常会卡死。可通过替换上文提到的三大模块仓库链接来实现彻底加速。

2.1. 替换底层 Git 仓库源

在终端依次执行：

# 替换 brew 工具本身源码库
git -C "$(brew --repo)" remote set-url origin https://mirrors.aliyun.com/homebrew/brew.git

# 替换核心软件配方库
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.aliyun.com/homebrew/homebrew-core.git

2.2. 替换 Bottles 预编译包下载源

修改 Shell 的启动配置注入环境变量。

• Zsh 用户 (macOS Catalina+ 默认):

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc

• Bash 用户:

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile

2.3. 终极提速：Aria2 强行并发 (可选)

让 Homebrew 调用多线程下载工具 Aria2 来拉取包文件：

export HOMEBREW_DOWNLOAD_STRATEGY=aria2

---

3. 核心使用指令速查

完成换源后，执行一次全量更新与健康检查：

brew update     # 抓取最新软件配方列表
brew doctor     # 检查系统环境是否存在潜在冲突

日常包管理：

brew install <package>           # 安装预编译包 (Bottles)
brew install --build-from-source openssl@3  # 强制使用源码在本地编译安装
brew upgrade <package>           # 升级单个软件
brew uninstall <package>         # 卸载软件
brew list                        # 列出所有通过 brew 安装的软件

4. 拓展：检查 Xcode CLI 依赖状态

Homebrew 强依赖于 Apple 的底层编译工具链，排障时可通过以下命令确认其版本：

xcodebuild -version                                # 查看完整 Xcode 版本
pkgutil --pkg-info=com.apple.pkg.CLTools_Executables # 单独检查命令行编译工具版本