homebrew 不支持真正自动切换镜像源，本质是通过脚本、环境变量或工具链在检测失败后手动触发源变更并重试；需同步配置四个环境变量以确保 git 仓库和 bottle 下载均走镜像。
homebrew 本身不支持“自动切换镜像源”——它没有内置的智能路由、网络质量探测或故障转移机制。所谓“自动切换”，实际是通过脚本、环境变量或工具链，在特定条件下手动触发源的变更，再配合合理的配置策略，模拟出接近自动的效果。核心思路是：检测失败 → 触发回退 → 切换源 → 重试操作。下面分几种实用路径说明。
镜像源切换的本质是修改 Git 远程地址
Homebrew 的 brew update 实际执行的是对几个关键 Git 仓库的 git pull：
-
brew自身（即Homebrew/brew） -
homebrew-core（核心 formula 仓库） -
homebrew-cask（GUI 应用仓库） -
homebrew-bottles（二进制包 CDN，由HOMEBREW_BOTTLE_DOMAIN环境变量控制）
所有“换源”操作，都是把它们的 origin 远程地址从 https://github.com/Homebrew/xxx 替换为国内镜像站的对应地址（如清华 TUNA、中科大 USTC、阿里云等）。
手动切换后可实现“半自动”回退
你可以在终端配置一个快捷函数，当 brew update 失败时一键切回国内源：
# 添加到 ~/.zshrc
brew-switch-to-tuna() {
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"
export HOMEBREW_CASK_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
brew tap --repair 2>/dev/null
brew update
}
运行 brew-switch-to-tuna 就能立刻应用清华源并更新。类似地，可定义 brew-switch-to-ustc 或 brew-switch-to-aliyun。
用 shell 函数封装“失败重试 + 源切换”逻辑
以下是一个轻量级自动降级示例（仅针对 brew update）：
safe-brew-update() {
echo "→ 尝试使用默认源更新..."
if brew update 2>/dev/null; then
echo "✓ 默认源成功"
return 0
else
echo "⚠ 默认源失败，切换至清华镜像..."
brew-switch-to-tuna
fi
}
把它加入 ~/.zshrc 后，日常就用 safe-brew-update 代替 brew update，遇到超时或连接失败会自动切源重试。
真正的“全自动”需依赖外部工具或定时任务
若希望完全免干预，可借助：
-
cron 定时检查：每天凌晨运行一次
brew update，失败则写日志并调用切换函数（适合长期无人值守的构建机） -
网络探测脚本：用
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.tuna.tsinghua.edu.cn判断镜像站是否可达，再决定启用哪个源 -
ZSH 插件（如
brew-command-not-found）：部分社区插件会在brew install报错时提示“是否切换镜像”，但非原生功能，需额外安装
注意：不建议让脚本在每次 brew install 前都做网络探测——这会明显拖慢命令响应速度，违背“加速初衷”。
关键提醒：别混淆“源地址”和“bottle 域名”
很多人只改了 core 和 cask 的 Git 地址，却忘了设置 HOMEBREW_BOTTLE_DOMAIN。结果 brew update 很快，但 brew install node 下载 bottle 时仍卡在 GitHub。务必四者同步：
| 项目 | 环境变量 | 示例值 |
|---|---|---|
| brew 仓库 | HOMEBREW_BREW_GIT_REMOTE |
https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git |
| core 仓库 | HOMEBREW_CORE_GIT_REMOTE |
https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git |
| cask 仓库 | HOMEBREW_CASK_GIT_REMOTE |
https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git |
| bottle 下载域名 | HOMEBREW_BOTTLE_DOMAIN |
https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles |
不复杂但容易忽略
