2025年MacOS Homebrew国内镜像加速完整指南：解决安装慢、下载卡顿问题 #48
Description
2025年MacOS Homebrew国内镜像加速完整指南：解决安装慢、下载卡顿问题
在MacOS上使用Homebrew（简称brew）安装软件时，许多用户都会遇到官方源访问慢、formula.jws.json文件下载超时、软件包拉取卡顿等问题——这是因为Homebrew默认连接的官方服务器位于海外，国内网络环境下容易出现网络波动或带宽限制。本文结合2025年最新镜像源情况，提供一套“一步到位”的加速配置方案，让brew安装速度从“龟速”变“飞速”。
一、为什么需要配置Homebrew国内镜像？
Homebrew的核心功能依赖两个关键资源：
- 软件包元数据：每次执行
brew install或brew update时，都会从官方地址https://formulae.brew.sh/api/formula.jws.json下载软件包信息（如版本、依赖、下载链接），国内访问该地址常因网络延迟导致超时； - 软件包本体：官方软件包（称为“bottle”）存储在海外服务器，下载速度通常只有几十KB/s，安装一个稍大的软件（如Python、Node.js）可能需要等待十几分钟甚至更久。
而国内镜像源（如中科大、清华等高校或企业提供的镜像）会实时同步Homebrew官方资源，将数据存储在国内服务器，访问速度可提升至几MB/s，彻底解决“安装慢”的痛点。
二、2025年推荐的Homebrew国内镜像源
目前国内稳定可用的Homebrew镜像源主要有两类，综合稳定性和同步速度，优先推荐中科大（USTC）镜像——其同步频率高、支持完整的Homebrew生态（包括brew本体、core核心库、bottle软件包、API接口），且2025年仍保持活跃维护。
| 镜像类型 | 中科大（USTC）镜像地址 | 作用说明 |
|---|---|---|
| Homebrew本体（brew.git） | https://mirrors.ustc.edu.cn/brew.git | 存储Homebrew核心程序代码，影响brew命令基础功能 |
| Homebrew核心库（core.git） | https://mirrors.ustc.edu.cn/homebrew-core.git | 存储软件包元数据（如安装规则、依赖关系） |
| Bottle软件包域名 | https://mirrors.ustc.edu.cn/homebrew-bottles | 加速软件包本体下载（如Python、Git等二进制包） |
| Homebrew API接口 | https://mirrors.ustc.edu.cn/homebrew-bottles/api | 2025年新版brew依赖的API接口，获取软件包最新信息 |
注意：阿里镜像曾因Git Clone兼容性问题导致部分软件安装失败，2025年仍未完全解决，因此暂不推荐。
三、一步到位：配置Homebrew国内镜像（图文教程）
配置过程仅需3步，适配所有MacOS版本（包括Sonoma、Ventura），且支持bash和zsh两种终端（MacOS新版默认使用zsh）。
步骤1：打开终端配置文件
根据你使用的终端类型，执行对应的命令打开配置文件：
- zsh用户（推荐，MacOS默认）：
vim ~/.zshrc - bash用户：
vim ~/.bash_profile
打开后会进入vim编辑模式（按i键切换到“插入模式”，此时可以输入文字）。
步骤2：添加镜像配置代码
在配置文件的末尾粘贴以下代码（直接复制即可，无需修改）：
# 🍺 Homebrew国内镜像加速配置（2025年更新，基于中科大镜像）
# 配置Homebrew本体镜像（brew.git）
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
# 配置Homebrew核心库镜像（homebrew-core.git）
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
# 配置Bottle软件包下载域名（加速软件安装）
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
# 配置新版Homebrew API接口镜像（2025年关键配置，解决formula.jws.json下载慢）
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
# 隐藏Homebrew环境变量提示（避免终端频繁弹出无关提示）
export HOMEBREW_NO_ENV_HINTS="1"粘贴完成后，按Esc键退出“插入模式”，再输入:wq（冒号+w+q）并按回车，保存配置并退出vim。
步骤3：让配置生效
执行以下命令，加载刚刚修改的配置文件，使其立即生效（无需重启终端）：
- zsh用户：
source ~/.zshrc
- bash用户：
source ~/.bash_profile
四、测试加速效果：安装软件秒级完成
配置完成后，我们通过安装一个常用软件（如GitHub命令行工具gh）测试速度：
brew install gh此时终端会显示下载地址为中科大镜像（如https://mirrors.ustc.edu.cn/homebrew-bottles/gh-xxx.tar.gz），下载进度条会以几MB/s的速度推进，原本需要几分钟的安装过程，现在几十秒内即可完成（如下图所示）：
(base) Apple@MacBook-Pro ~ % brew install gh
Downloading https://mirrors.ustc.edu.cn/homebrew-bottles/api/formula.jws.json
######################################################################## 100.0%
Downloading https://mirrors.ustc.edu.cn/homebrew-bottles/gh-2.74.0.arm64_ventura.bottle.tar.gz
######################################################################## 100.0%
Pouring gh-2.74.0.arm64_ventura.bottle.tar.gz
Summary
/opt/homebrew/Cellar/gh/2.74.0: 214 files, 35.8MB
如果仍遇到下载慢，可执行brew update更新Homebrew索引后再尝试——更新过程也会使用国内镜像，速度同样会大幅提升。
五、常见问题排查（2025年适用）
-
配置后执行
brew命令提示“command not found”
原因：配置文件路径错误。解决方案：确认终端类型（执行echo $SHELL，输出/bin/zsh则为zsh，/bin/bash则为bash），重新执行对应终端的配置文件编辑和生效命令。 -
下载软件时提示“SSL证书错误”
原因：MacOS系统时间与网络时间不同步。解决方案：打开“系统设置→日期与时间”，勾选“自动设置日期与时间”，同步后重新执行安装命令。 -
brew update时提示“git pull failed”
原因：之前使用过其他镜像，导致本地Git仓库冲突。解决方案：执行以下命令重置Homebrew仓库并重新同步：# 重置brew本体仓库 cd "$(brew --repo)" && git remote set-url origin https://mirrors.ustc.edu.cn/brew.git && git pull # 重置homebrew-core仓库 cd "$(brew --repo homebrew/core)" && git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git && git pull
通过以上配置，MacOS的Homebrew就能彻底摆脱“下载慢”的困扰，无论是安装开发工具（如Python、Node.js）、办公软件（如Chrome），还是系统工具（如Git），都能实现“秒级启动、飞速安装”。建议将本文收藏，后续更换Mac或重装系统时，可直接复用这套配置方案。