在zsh中让homebrew镜像源永久生效，需先确保brew命令可用并加入path，再将中科大镜像地址写入~/.zshrc并执行source ~/.zshrc；最后运行brew update验证是否生效。
在 zsh 中让 homebrew 镜像源永久生效，核心是把镜像地址写进 shell 启动配置文件（~/.zshrc），并确保 brew 命令本身能被系统识别。只要这两步到位，每次新开终端都会自动加载镜像设置。
确认 brew 命令可用是前提
如果连 brew --version 都报错 “command not found”，镜像配置再完整也起不了作用。先检查 brew 是否已安装且路径已加入 PATH：
- 运行
which brew，正常应返回类似/opt/homebrew/bin/brew（Apple Silicon）或/usr/local/bin/brew（Intel） - 若无输出，说明 PATH 没包含 brew 所在目录。执行以下命令添加（以 Apple Silicon 为例）：
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 再运行
brew --version确认成功
写入中科大镜像源（推荐，同步及时）
中科大镜像在国内稳定性与更新速度表现均衡，适合大多数用户。直接追加到 ~/.zshrc：
- 执行以下命令一次性写入（复制粘贴即可）：
cat >> ~/.zshrc # Homebrew 中科大镜像源<br>export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"<br>export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"<br>export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"<br>EOF
- 立即生效：
source ~/.zshrc - 验证是否加载成功：
echo $HOMEBREW_BOTTLE_DOMAIN应输出https://mirrors.ustc.edu.cn/homebrew-bottles
验证镜像是否真正生效
环境变量写对了，不等于 brew 就会用它——还需触发一次元数据刷新：
- 运行
brew update，观察日志开头是否出现Fetching: https://mirrors.ustc.edu.cn/...类似路径 - 首次运行可能稍慢（要拉取新索引），但后续会明显快于官方源（几秒内完成）
- 可进一步测试安装一个小包：
brew install wget，看下载地址是否为中科大域名
其他常见情况处理
部分用户可能遇到配置看似正确但依然走 GitHub 的情况，注意以下几点：
- Homebrew 4.0+ 默认启用 API 模式，
HOMEBREW_CORE_GIT_REMOTE在普通使用中非必需；但如果曾手动 clone 过homebrew-core，需进入该目录执行git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git - 如果之前用过清华源或其他镜像，建议先清理旧配置：
grep -n "HOMEBREW_" ~/.zshrc查看是否有重复或冲突行，手动删掉再重写 - 改完
~/.zshrc后务必执行source ~/.zshrc，否则只对当前终端生效
