【Mac必备】2026年国内高速安装&配置Homebrew全攻略（中科大/清华镜像 + 一键脚本）

在国内用Homebrew（macOS/Linuxbrew 的神器）最烦的就是：

• 官方安装脚本卡在 git fetch 或 curl 56 Connection reset by peer
• brew update 慢如龟速
• brew install 大包（如 node、python、ffmpeg）下载几十KB/s，卡半天

这些问题99%是因为网络对GitHub的访问不稳定或限速。
好消息是：通过国内镜像源，可以把速度提升到几MB/s ~ 十几MB/s，安装和更新基本秒开！

本文整理了2026年最稳定、推荐的几种方式（实测有效），包括：

• 一键脚本（最懒人）
• 中科大 USTC 镜像（目前最稳，同步快）
• 清华 TUNA 镜像（瓶子下载特别友好）
• 常见问题排查

适用于 Apple Silicon (M1/M2/M3/M4 Mac mini 等) 和 Intel Mac。

一、为什么一定要用国内镜像？

核心配置其实就几行环境变量，Homebrew 从 4.0+ 开始默认走 API，大部分用户无需再手动 clone core 仓库了！

二、最推荐方式：一键安装脚本（HomebrewCN）

如果你是新手或重装，直接用这个脚本最省事。它会让你选镜像源（中科大/清华/阿里等），自动配置，基本一次过。

# macOS 默认 zsh，用这个（bash 用户把 zsh 改 bash 即可）
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

运行后：

1. 出现选项菜单，选择 1（中科大源） 或 2（清华源）（推荐中科大，同步最及时）
2. 它会自动处理 sudo、下载、配置环境变量
3. 装完后验证：

brew --version
brew update   # 应该飞快
brew doctor   # 检查问题

优点：傻瓜式，自动选最优源，适合99%用户。
缺点：依赖 Gitee，如果 Gitee 偶尔抽风，可用下面手动方式。

三、手动方式：永久配置中科大 USTC 镜像（2026推荐首选）

中科大镜像目前同步频率最高、瓶子最全、稳定性强。

步骤

1. 清理旧残留（防止冲突，Apple Silicon 用 /opt/homebrew）

sudo rm -rf /opt/homebrew
# 如果是 Intel Mac： sudo rm -rf /usr/local/Homebrew

2. 编辑 shell 配置文件（macOS 默认 zsh，用 ~/.zshrc；bash 用 ~/.bash_profile 或 ~/.bashrc）

nano ~/.zshrc
# 或 vim ~/.zshrc

3. 在文件末尾添加以下内容（完整推荐配置）：

# ===================== Homebrew 国内镜像加速（中科大 USTC） =====================
# Homebrew 核心仓库（brew.git）
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"

# 如果需要开发命令（如 brew cat formula），才设置 core（大多数人可省略）
# export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"

# Cask（图形软件）镜像，可选但推荐
export HOMEBREW_CASK_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-cask.git"

# 二进制瓶子（bottles）加速 - 下载速度关键！
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"

# API 元数据加速（formula.json 等，brew 4.0+ 默认用这个，超级重要）
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"

# 可选：禁止自动更新（想手动控制时加）
# export HOMEBREW_NO_AUTO_UPDATE=1
# ===================== 配置结束 =====================

保存退出（nano: Ctrl+O → 回车 → Ctrl+X）

4. 立即生效

source ~/.zshrc

5. 安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• 安装过程会自动走你设的镜像，速度飞起。
• 装完后跟着提示加 eval "$(/opt/homebrew/bin/brew shellenv)" 到 ~/.zprofile（Apple Silicon）或 ~/.bash_profile（Intel）。

6. 验证

brew update   # 看是否走 mirrors.ustc.edu.cn
brew install gh   # 测试安装一个小的，观察下载地址和速度

四、备选：清华 TUNA 镜像配置

如果中科大偶尔不稳，换清华（瓶子下载特别友好）：

替换上面 export 中的地址为：

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"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"

然后 source ~/.zshrc，再 brew update。

五、常见问题 & 排查

1. 还是卡在 git fetch / early EOF
   → 换手机热点试试（家/公司网络常被限速）
   → 加 git 缓冲：git config --global http.postBuffer 524288000

2. brew update 还是慢
   → echo $HOMEBREW_API_DOMAIN 检查是否生效
   → unset 所有变量对比官方速度，确认是网络问题

3. 想恢复官方源
   unset 所有 HOMEBREW_ 开头的 export，然后 brew update。

4. M4 Mac mini 注意
   路径是 /opt/homebrew，命令前加 eval “$(/opt/homebrew/bin/brew shellenv)” 已自动处理。

六、结语

用上国内镜像后，Homebrew 真正变成了“家常便饭”工具：

• brew install wget git node python ffmpeg …… 基本几十秒搞定
• 再也不用半夜等下载了

推荐顺序：

1. 先试 HomebrewCN 一键脚本（懒人首选）
2. 手动永久配置中科大源（稳定党首选）
3. 清华源作为备用

有任何报错欢迎评论区贴出来，一起解决～
喜欢的话点个赞+收藏，帮到更多 Mac 开发者！

（完）

转载自CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/weixin_39372311/article/details/158841635