当前位置：首页 > article >正文

更换Homebrew 源

article 2025/8/23 13:11:16

以下是查看和修改 Homebrew 源的详细步骤，适用于需要切换到国内镜像以加速下载的场景：

1. 查看当前 Homebrew 源

# 查看 brew 主仓库地址
git -C "$(brew --repo)" remote get-url origin# 查看 homebrew-core 仓库地址
git -C "$(brew --repo homebrew/core)" remote get-url origin# 查看 homebrew-cask 仓库地址（如安装了 cask）
git -C "$(brew --repo homebrew/cask)" remote get-url origin

2. 修改为国内镜像源（以中科大镜像为例）

# 设置 brew 主仓库
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git# 设置 homebrew-core 仓库
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git# 设置 homebrew-cask 仓库（可选）
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git# 刷新缓存
brew update

3. 其他国内镜像源选项

清华大学镜像：

# brew 主仓库
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git# homebrew-core
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git# homebrew-cask
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

阿里云镜像：

# brew 主仓库
git -C "$(brew --repo)" remote set-url origin https://mirrors.aliyun.com/homebrew/brew.git# homebrew-core
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.aliyun.com/homebrew/homebrew-core.git

4. 恢复为官方源

# brew 主仓库
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git# homebrew-core
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git# homebrew-cask
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git

5. 验证修改是否成功

再次运行步骤 1 的命令，确认输出的仓库地址已变更为所选镜像源。

注意事项

中科大镜像限制：中科大镜像仅支持 macOS 和 Linux 系统，不支持 Windows。
环境变量影响：如果设置了 HOMEBREW_BREW_GIT_REMOTE 或 HOMEBREW_CORE_GIT_REMOTE 环境变量，可能会覆盖手动设置的源。检查并删除这些环境变量：
```
unset HOMEBREW_BREW_GIT_REMOTE
unset HOMEBREW_CORE_GIT_REMOTE
```
更新问题：切换镜像后若遇到更新失败，可尝试清除缓存并重新更新：
```
brew cleanup
brew update --force
```