homebrew国内镜像需覆盖安装脚本、主仓库、homebrew-core、homebrew-cask及bottle五大环节；apple silicon装在/opt/homebrew，intel在/usr/local；推荐用homebrewcn一键脚本或手动四步换源（含bottle域名），最后用brew update/install/config验证。
homebrew 在 macos 上默认走 github 和 ghcr.io，国内直连经常超时或中断。配置国内镜像源不是“换一个地址”就完事，而是要覆盖安装脚本、核心仓库（homebrew-core）、cask 仓库（homebrew-cask）和预编译包（bottle）这四个关键环节。下面按实际操作顺序说明。
确认芯片类型再动手
Apple Silicon（M1/M2/M3/M4）默认装在 /opt/homebrew，Intel Mac 默认装在 /usr/local。路径错了，后续所有命令都会失败。运行这条命令看清楚：
echo $HOMEBREW_PREFIX
输出是 /opt/homebrew 就是 M 系列；是 /usr/local 就是 Intel。
安装阶段直接用国内脚本（推荐新手）
别硬跑官方安装命令，容易卡在 raw.githubusercontent.com。用已验证的国内一键脚本：
- 打开终端，粘贴执行：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
它会自动检测芯片类型、替换 brew 主仓库、core 仓库、bottle 域名，并完成 PATH 注入。安装完直接
brew --version验证。
已安装 brew 的用户：手动换源四步到位
如果 brew 已存在但很慢，需依次改四个地址：
-
改主仓库（brew 自身）：
cd "$(brew --repo)" git remote set-url origin https://mirrors.ustc.edu.cn/brew.git
-
改核心公式仓库（homebrew-core）：
cd "$(brew --repo homebrew-core)" git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
-
改图形应用仓库（homebrew-cask）：
cd "$(brew --repo homebrew-cask)" git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
-
改二进制包下载地址（bottle）：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc source ~/.zshrc
中科大源（USTC）稳定性好，清华源（
https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles）更新快，阿里云源（https://mirrors.aliyun.com/homebrew-bottles）下载峰值高——按你网络实测选一个即可。
验证是否生效
运行三步检查：
-
brew update应快速完成，不卡在 “Fetching latest commit…” -
brew install wget能顺利下载.tar.gz或.bottle.tar.gz -
brew config | grep -E "(Bottle|Git Remote)"应显示国内域名
如果某步失败，大概率是路径或 shell 配置没生效，重新 source ~/.zshrc 或重启终端再试。
