解决brew安装慢问题

用 brew 安装软件慢,通常是因为默认的官方源服务器在国外。解决的核心思路就是将默认源替换为国内的镜像源。对于2025年的新版 Homebrew,有一个关键的新步骤需要留意。

💡 核心原因

Homebrew 慢主要是因为它的核心仓库和软件包(Bottles)都托管在GitHub等国外服务器上,国内网络连接不稳定、速度慢。替换为国内镜像(如清华、中科大、阿里云等)可以显著提升速度。

🚀 详细解决方案

第一步:配置环境变量(最关键的一步)

这是当前新版 Homebrew 加速的核心。从2024年起,Homebrew 默认优先通过 API 获取信息,因此除了替换传统的 Git 仓库地址,必须配置 HOMEBREW_API_DOMAIN 环境变量指向国内镜像的 API 地址

  1. 打开终端,根据你使用的 Shell,输入以下命令之一来编辑配置文件:

    • 如果你使用 zsh (macOS Catalina及以后默认):open ~/.zshrc
    • 如果你使用 bash (旧版本macOS):open ~/.bash_profile
  2. 在打开的文件末尾,添加以下配置。这里以中科大(USTC)镜像 为例,它是目前反馈较好、更新及时的源之一:

    bash 复制代码
    # Homebrew 国内镜像加速配置 (USTC)
    # 替换 Homebrew 核心代码仓库
    export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
    # 替换核心软件包仓库(如果使用 Git 方式)
    export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
    # 替换预编译二进制包(bottles)的下载地址
    export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
    # 重点:替换 Homebrew 的 API 镜像源,解决新版 brew 的更新慢问题
    export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
    # (可选)屏蔽环境变量提示,让终端更清爽
    export HOMEBREW_NO_ENV_HINTS="1"
  3. 保存文件并退出 ,然后执行以下命令让配置立即生效:

    bash 复制代码
    source ~/.zshrc  # 如果你用的是 zsh
    # 或者
    source ~/.bash_profile # 如果你用的是 bash
第二步:更换核心仓库的 Git 地址

这一步是替换 Homebrew 本体和核心仓库的 Git 远程地址。在终端中逐条执行以下命令:

bash 复制代码
# 更换 Homebrew 核心代码仓库
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

# 更换 Cask 仓库(用于安装GUI应用,如Chrome)
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
第三步:应用配置并更新

运行更新命令,使所有更改生效:

bash 复制代码
brew update

如果配置正确,这次更新过程会变得非常快。

✨ 其他实用技巧

  • 临时禁用自动更新 :如果你急着安装一个软件,不想等待 brew update,可以临时设置环境变量跳过更新。在运行 brew install 命令前加上它即可:

    bash 复制代码
    HOMEBREW_NO_AUTO_UPDATE=1 brew install <你要安装的软件名>

    如果想永久生效,可以将 export HOMEBREW_NO_AUTO_UPDATE=1 也添加到你的 ~/.zshrc 文件中。

  • 清理旧缓存:如果配置后速度提升不明显,可以尝试清理一下 Homebrew 的缓存:

    bash 复制代码
    brew cleanup
  • 如何验证配置成功? 运行 brew config 命令,查看输出结果中的 HOMEBREW_BREW_GIT_REMOTEHOMEBREW_BOTTLE_DOMAINHOMEBREW_API_DOMAIN 是否已经指向了你设置的国内镜像地址。

相关推荐
wonderomg1 天前
Mac安装openclaw步骤
macos·openclaw
whatzhang0071 天前
在 macOS 上从零配置 Vim:开启语法高亮 + 安装 vim-polyglot + 设置 gruvbox 主题
macos·vim·excel
徐健峰1 天前
Claude Code 安装完全指南(Mac 版):Git、环境变量、PATH 与常见报错一次讲清(2026)
git·macos·arcgis
AppOS1 天前
手把手教你 Openclaw 在 Mac 上本地化部署,保姆级教程!接入飞书打造私人 AI 助手
人工智能·macos·飞书
qing222222222 天前
Linux中修改mac地址(重启后依然生效)
linux·服务器·macos
GameTomato2 天前
【Xcode】【资源创建失败】【XCode更新最新版】XCode更新最新版,创建资源文件夹一直读取不到的问题
ide·macos·xcode
William.csj2 天前
Mac——加密压缩
macos·压缩
时空无限2 天前
mac 如何用命令行操作 vscode 打开哪个文件夹
ide·vscode·macos
小镇学者2 天前
【python】MacOS下永久配置pip镜像源
macos·pip
海参崴-2 天前
三足鼎立:Linux、苹果macOS与微软Windows的前世今生及核心差异
linux·microsoft·macos