macOS Homebrew 镜像源怎么优化更新速度-Mac OS-PHP中文网

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 表示通路正常