在MacOS上使用Homebrew（简称brew）安装软件时，许多用户都会遇到官方源访问慢、
formula.jws.json文件下载超时、软件包拉取卡顿等问题——这是因为Homebrew默认连接的官方服务器位于海外，国内网络环境下容易出现网络波动或带宽限制。📝 MacOS Homebrew国内镜像加速完整指南：解决安装慢、下载卡顿问题
一、为什么需要配置Homebrew国内镜像？
Homebrew的核心功能依赖两个关键资源：
- 软件包元数据：每次执行
brew install或brew update时，都会从官方地址https://formulae.brew.sh/api/formula.jws.json下载软件包信息（如版本、依赖、下载链接），国内访问该地址常因网络延迟导致超时；
- 软件包本体：官方软件包（称为“bottle”）存储在海外服务器，下载速度通常只有几十KB/s，安装一个稍大的软件（如Python、Node.js）可能需要等待十几分钟甚至更久。
而国内镜像源（如中科大、清华等高校或企业提供的镜像）会实时同步Homebrew官方资源，将数据存储在国内服务器，访问速度可提升至几MB/s，彻底解决“安装慢”的痛点。
二、推荐的Homebrew国内镜像源
目前国内稳定可用的Homebrew镜像源主要有两类，综合稳定性和同步速度，优先推荐中科大（USTC）镜像——其同步频率高、支持完整的Homebrew生态（包括brew本体、core核心库、bottle软件包、API接口），且2025年仍保持活跃维护。
镜像类型 | 中科大（USTC）镜像地址 | 作用说明 |
Homebrew本体（brew.git） | 存储Homebrew核心程序代码，影响 brew命令基础功能 | |
Homebrew核心库（core.git） | 存储软件包元数据（如安装规则、依赖关系） | |
Bottle软件包域名 | 加速软件包本体下载（如Python、Git等二进制包） | |
Homebrew API接口 | 2025年新版brew依赖的API接口，获取软件包最新信息 |
注意：阿里镜像曾因Git Clone兼容性问题导致部分软件安装失败，2026年仍未完全解决，因此暂不推荐。
三、配置Homebrew国内镜像
配置过程仅需3步，适配所有MacOS版本（包括Sonoma、Ventura），且支持bash和zsh两种终端（MacOS新版默认使用zsh）。
步骤1：打开终端配置文件
根据你使用的终端类型，执行对应的命令打开配置文件：
- zsh用户（推荐，MacOS默认）：
- bash用户：
打开后会进入vim编辑模式（按
i键切换到“插入模式”，此时可以输入文字）。步骤2：添加镜像配置代码
在配置文件的末尾粘贴以下代码（直接复制即可，无需修改）：
粘贴完成后，按
Esc键退出“插入模式”，再输入:wq（冒号+w+q）并按回车，保存配置并退出vim。步骤3：让配置生效
执行以下命令，加载刚刚修改的配置文件，使其立即生效（无需重启终端）：
- zsh用户：
- bash用户：
四、测试加速效果：安装软件秒级完成
配置完成后，我们通过安装一个常用软件（如GitHub命令行工具
gh）测试速度：此时终端会显示下载地址为中科大镜像（如
https://mirrors.ustc.edu.cn/homebrew-bottles/gh-xxx.tar.gz），下载进度条会以几MB/s的速度推进，原本需要几分钟的安装过程，现在几十秒内即可完成（如下图所示）：如果仍遇到下载慢，可执行
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仓库并重新同步：