Homebrew在macOS上更新慢的根本原因是默认从海外服务器拉取全部资源，必须同步替换brew.git、homebrew-core.git、HOMEBREW_BOTTLE_DOMAIN和HOMEBREW_API_DOMAIN四个部分才能显著提速。Homebrew 在 macOS 上更新慢，核心问题不是它本身卡，而是默认所有资源都从海外服务器拉取——包括程序本体、软件配方、预编译包和 API 接口。只换其中一两个地址，效果有限；必须四块同步切换，才能真正提速。
必须同步替换的四个关键部分
homebrew 的下载链路分四段，每一段都可能成为瓶颈：
-
brew.git：Homebrew 程序自身代码，执行
brew update时最先更新它 - homebrew-core.git：6000+ 命令行工具（如 git、python、curl）的安装脚本库
- HOMEBREW_BOTTLE_DOMAIN：预编译二进制包（bottles）的下载域名，大软件（node、rust）靠它省去数小时编译
-
HOMEBREW_API_DOMAIN：用于查询包信息的 API 地址，新版 brew 默认从
formulae.brew.sh/api/...拉取，这步在国内常卡住几秒到几十秒
推荐镜像源对比与配置命令
清华、中科大、阿里云是当前最稳的三个选择。实测中，阿里云同步频率最高（每15分钟），带宽最大（10Gbps），对 bottles 支持最全；清华延迟低（≤2 小时）、教育网友好；中科大 CDN 覆盖强，华东地区响应最快。
以阿里云为例，一次性执行以下命令（适用于 zsh 用户，bash 用户请改写入 ~/.bash_profile）：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
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 echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew-bottles' >> ~/.zshrc echo 'export HOMEBREW_API_DOMAIN=https://mirrors.aliyun.com/homebrew-bottles/api' >> ~/.zshrc source ~/.zshrc
Apple Silicon（M1/M2/M3）用户特别注意
芯片架构影响路径和 shell 环境：
- 确认终端用的是
zsh：运行echo $SHELL，输出应为/bin/zsh - 确保
~/.zshrc已加载：执行source ~/.zshrc或重启终端 - 检查 Homebrew 安装路径：
brew --prefix，Apple Silicon 返回/opt/homebrew，Intel 返回/usr/local；路径不同，环境变量写法也不同
验证是否生效的三步检查法
配置完别急着装软件，先验证：
- 运行
brew update，观察是否跳过超时错误，且速度明显加快（通常 10–30 秒内完成） - 执行
brew config | grep -E "(API|BOTTLE|remote)"，确认所有域名已指向国内镜像 - 手动测试 API 响应：
curl -s -o /dev/null -w "%{http_code}\n" https://mirrors.aliyun.com/homebrew-bottles/api/formula.jws.json，返回200表示通路正常
