2025 Homebrew 配置 brew install 国内镜像源指南，快速安装加速（01月13日更新）

猫头虎

发布于 2025-01-15 08:27:38

2.5K00

代码可运行

文章被收录于专栏：猫头虎博客专区猫头虎博客专区

运行总次数：0

代码可运行

2025 Homebrew 配置 brew install 国内镜像源指南，快速安装加速（01月13日更新）

大家好！👋 今天我们来聊一聊如何在国内使用 Homebrew 进行加速安装，解决由于网络延迟导致的安装缓慢问题。无论是开发者，还是学习 Python、Ruby、Node.js 等语言的同学，都可能会遇到这个问题。🌍

本文会提供详细的配置步骤，通过国内镜像源加速 Homebrew 的 brew install 操作。🎯

正文

为什么需要配置国内镜像源？

在国内，使用 Homebrew 时，由于网络原因，往往会遭遇下载速度极慢或者根本无法连接的问题。😓 这不仅浪费时间，还可能影响工作进度。幸运的是，Homebrew 支持自定义镜像源，因此我们可以通过设置国内镜像来提高下载速度。

通过设置 国内镜像源，你可以在 brew install 时享受到更快的下载速度。💨

配置步骤：国内镜像源选择与设置

1. 选择国内镜像源

目前，许多国内开源社区提供了 Homebrew 镜像源，最常用的几个是：

清华大学镜像：https://mirrors.tuna.tsinghua.edu.cn
中科大镜像：https://mirrors.ustc.edu.cn
阿里云镜像：https://developer.aliyun.com/mirror/

2. 配置 Homebrew 镜像

在终端中执行以下命令，将 Homebrew 的源切换为 国内镜像源：

清华大学镜像：

# 配置 Homebrew 核心镜像
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

# 配置 Homebrew 公式镜像
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

# 配置 Homebrew Bottles 镜像
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles

中科大镜像：

# 配置 Homebrew 核心镜像
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git

# 配置 Homebrew 公式镜像
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

# 配置 Homebrew Bottles 镜像
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles

阿里云镜像：

# 配置 Homebrew 核心镜像
git -C "$(brew --repo)" remote set-url origin https://mirrors.aliyun.com/homebrew/brew.git

# 配置 Homebrew 公式镜像
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.aliyun.com/homebrew/homebrew-core.git

# 配置 Homebrew cask 镜像
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.aliyun.com/homebrew/homebrew-cask.git

# 配置 Homebrew Bottles 镜像
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew-bottles

3. 更新与检查配置

设置完镜像源后，运行以下命令更新 Homebrew 配置并检查镜像源是否生效：

brew update

如果一切配置正确，你会看到国内镜像源正在被使用，而且速度会明显提升！⚡️

如何验证配置是否成功？

你可以通过运行以下命令来确认你的镜像源是否已经成功配置：

brew config

查看输出内容中的 HOMEBREW_GIT_REMOTE 和 HOMEBREW_BOTTLE_DOMAIN，它们应该指向你设置的国内镜像源地址。

Warm Tips

常见问题：

为什么镜像源切换后仍然很慢？ 可能是因为 Homebrew 的缓存未清除。你可以尝试使用 brew cleanup 命令清除旧的缓存。

如何切换回官方源？ 如果你想恢复使用官方源，只需执行以下命令：

git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git
export HOMEBREW_BOTTLE_DOMAIN=https://homebrew.bintray.com