国内高速安装与配置 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）
