homebrew换源需同步修改三处地址：brew本体源、homebrew-core配方仓库、homebrew-bottles二进制下载域名，缺一不可；推荐中科大镜像，执行三行export命令后运行brew update，并写入~/.zshrc永久生效。

homebrew 镜像源的“扩展地址”其实是指它依赖的多个关键仓库和下载路径，不只是主仓库（brew.git）一个地方。改对全部三处，才算真正完成换源，否则仍可能卡在 brew update 或下载 bottle 时慢/失败。

需要修改的三个核心地址

Homebrew 运行时实际访问以下三类资源，每类对应一个独立地址：

• brew 本体源：Homebrew 自身代码仓库，控制 brew 命令更新逻辑
• homebrew-core 源：所有命令行软件（如 git、node、python）的配方（formula）仓库
• homebrew-bottles 域名：预编译二进制包的下载地址，影响 brew install 实际下载速度，最关键

中科大镜像源完整配置（推荐稳定）

直接复制粘贴执行以下三行命令（一次性粘贴，回车运行）：

export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"

再立即执行：

brew update

这能让当前终端会话立刻生效。但重启终端后会失效，需写入配置文件。

让修改永久生效（写入 shell 配置）

macOS 默认使用 zsh，所以编辑 ~/.zshrc：

macOS Notes

通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载

nano ~/.zshrc

滚动到底部，粘贴上面三行 export 语句，保存退出（Ctrl+O → Enter → Ctrl+X），然后加载：

source ~/.zshrc

验证是否写入成功，可运行：

echo $HOMEBREW_BOTTLE_DOMAIN

应输出 https://mirrors.ustc.edu.cn/homebrew-bottles。

其他常用镜像源地址（可替换使用）

若中科大偶尔不稳定，可换成清华或阿里云源，仅需把 URL 替换即可：

• 清华大学镜像：
  HOMEBREW_BREW_GIT_REMOTE → https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
HOMEBREW_CORE_GIT_REMOTE → https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
HOMEBREW_BOTTLE_DOMAIN → https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
• 阿里云镜像：
  HOMEBREW_BREW_GIT_REMOTE → https://mirrors.aliyun.com/homebrew/brew.git
HOMEBREW_CORE_GIT_REMOTE → https://mirrors.aliyun.com/homebrew/homebrew-core.git
HOMEBREW_BOTTLE_DOMAIN → https://mirrors.aliyun.com/homebrew-bottles