国内高速安装与配置 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，安装和更新基本秒开。
本文整理了最稳定、推荐的几种方式（实测有效），包括：
- 一键脚本（最懒人）
- 中科大 USTC 镜像（目前最稳，同步快）
- 清华 TUNA 镜像（瓶子下载特别友好）
- 常见问题排查
适用于 Apple Silicon (M1/M2/M3/M4 Mac mini 等) 和 Intel Mac。
一、为什么一定要用国内镜像？
| 问题类型 | 官方源表现 | 国内镜像表现 |
|---|---|---|
| git clone / fetch | 经常 early EOF / reset | 稳定，秒级完成 |
| brew update | 几分钟～十几分钟 | 几秒～几十秒 |
| brew install bottle | 几十 KB/s ~ 几百 KB/s | 5-20MB/s+（视网络） |
| API 元数据 (formula.json) | 经常超时 | 瞬间返回 |
核心配置其实就几行环境变量，Homebrew 从 4.0+ 开始默认走 API，大部分用户无需再手动 clone core 仓库了！
二、最推荐方式：一键安装脚本（HomebrewCN）
如果你是新手或重装，直接用这个脚本最省事。它会让你选镜像源（中科大/清华/阿里等），自动配置，基本一次过。
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
运行后：
- 出现选项菜单，选择 1（中科大源） 或 2（清华源）（推荐中科大，同步最及时）
- 它会自动处理 sudo、下载、配置环境变量
- 装完后验证：
brew --version
brew update # 应该飞快
brew doctor # 检查问题
优点：傻瓜式，自动选最优源，适合 99% 用户。 缺点：依赖 Gitee，如果 Gitee 偶尔抽风，可用下面手动方式。
三、手动方式：永久配置中科大 USTC 镜像（2026 推荐首选）
中科大镜像目前同步频率最高、瓶子最全、稳定性强。
步骤
- 清理旧残留（防止冲突，Apple Silicon 用
/opt/homebrew）
sudo rm -rf /opt/homebrew # 如果是 Intel Mac：sudo rm -rf /usr/local/Homebrew
- 编辑 shell 配置文件（macOS 默认 zsh，用
~/.zshrc；bash 用~/.bash_profile或~/.bashrc）
nano ~/.zshrc # 或 vim ~/.zshrc
- 在文件末尾添加以下内容（完整推荐配置）：
# ===================== 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）
- 立即生效
source ~/.zshrc
- 安装 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）。
- 验证
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。
五、常见问题 & 排查
- 还是卡在 git fetch / early EOF
→ 换手机热点试试（家/公司网络常被限速）
→ 加 git 缓冲：git config --global http.postBuffer 524288000 - brew update 还是慢
→ echo $HOMEBREW_API_DOMAIN 检查是否生效
→ unset 所有变量对比官方速度，确认是网络问题 - 想恢复官方源
unset 所有 HOMEBREW_ 开头的 export，然后brew update。 - M4 Mac mini 注意
路径是/opt/homebrew，命令前加eval "$(/opt/homebrew/bin/brew shellenv)"已自动处理。
六、结语
用上国内镜像后，Homebrew 真正变成了'家常便饭'工具：
brew install wget git node python ffmpeg ……基本几十秒搞定- 再也不用半夜等下载了
推荐顺序：
- 先试 HomebrewCN 一键脚本（懒人首选）
- 手动永久配置中科大源（稳定党首选）
- 清华源作为备用
