Homebrew国内卡顿需同步替换三类地址：安装脚本（raw.githubusercontent.com）、仓库（github.com）、预编译包（ghcr.io）均指向清华或中科大等国内镜像，并按芯片架构（arm64/x86_64）选择对应路径及配置。
homebrew 在国内用得卡，不是它本身有问题，而是默认所有下载地址都指向海外服务器——raw.githubusercontent.com、github.com、ghcr.io 这几个关键节点在国内访问极不稳定。适配国内网络环境，核心就一件事：把这三类请求全部切到国内镜像源，而不是只改其中一两个。
确认芯片架构再动手
Apple Silicon（M1/M2/M3/M4）和 Intel Mac 的安装路径、命令前缀完全不同。M 系列默认装在 /opt/homebrew，Intel 默认在 /usr/local。如果脚本或命令里硬写路径却没匹配芯片，会直接报错 No such file or directory。所以第一步永远是运行：
arch
看到 arm64 就是 M 芯片，看到 x86_64 就是 Intel。后续所有配置都要按这个来。
一键安装推荐用 HomebrewCN 脚本
这是目前最省心、适配最全的方案，自动识别芯片、自动选镜像、自动清理残留。打开终端粘贴执行：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
运行后会提示选镜像源（1 中科大、2 清华、3 阿里云），输入数字回车即可。它会自动完成：
- 替换
brew本体仓库地址 - 替换
homebrew-core和homebrew-cask的 git 地址 - 配置
HOMEBREW_BOTTLE_DOMAIN指向国内 bottle 下载地址 - 补全环境变量（如
PATH）
手动换源要覆盖三个环节
如果已装好 brew 但速度仍慢，说明只换了部分源。必须同步调整以下三项：
-
核心仓库地址（git remote）
cd "$(brew --repo)" git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core" git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git cd "$(brew --repo)/Library/Taps/homebrew/homebrew-cask" git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git
-
Bottle 下载地址（二进制包）
在~/.zshrc或~/.bash_profile末尾添加：export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
然后运行
source ~/.zshrc生效。 -
API 元数据地址（Homebrew 4.x 必须）
同样在 shell 配置文件中追加：export HOMEBREW_API_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-api
清华和中科大镜像怎么选
两者都稳定，差别主要在实际网络表现：
- 清华 TUNA：通常瓶包（bottle）下载更快，峰值可达 15MB/s，适合常装大软件（如
node,python,ffmpeg） - 中科大 USTC：git 仓库同步更稳，尤其在更新
brew update时不易中断，适合频繁拉取公式变动的开发者
如果发现 brew update 卡住，优先换中科大；如果 brew install 下载慢，优先换清华。
验证是否生效
换源完成后，运行：
brew update && brew doctor
观察输出里是否有 Fetching origin 或 Downloading from 开头的地址变成 mirrors.tuna.tsinghua.edu.cn 或 mirrors.ustc.edu.cn。再试装一个轻量工具，比如：
brew install wget
看下载速度是否从几十 KB/s 跳到几 MB/s，基本就到位了。
