简介：

作为macOS用户，开发过程中总是绕不开优秀的包管理工具 Homebrew。但是不少国内用户在安装homebrew时，总是不断出现下载失败、超时、访问 GitHub 较慢甚至直接报错的问题，例如：

fatal: unable to access 'https://github.com/Homebrew/brew/': Error in the HTTP2 framing layer

或者类似：

Warning: formula.jws.json: update failed, falling back to cached version.

fatal: cannot change to '/opt/homebrew/Library/Taps/homebrew/homebrew-core': No such file or directory

诸如此类的问题反复出现，严重耽误了开发进度、影响了心情，甚至会让你对macOS和Homebrew感到烦躁。

今天，我将提供一个**最新、最佳、简单有效的方法**，帮助所有国内的小伙伴快速、稳定地完成安装并长期无忧使用Homebrew。

一、为什么安装brew总是失败？

从本质上讲，目前国内访问国外GitHub网络环境不佳，总是会超时失败，造成类似错误：

  • Git clone brew 源不成功

  • 访问brew仓库超时或失败

  • brew 核心库缺失 (homebrew-core) 导致软件根本装不上

我们一直推荐的常规安装脚本：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

在国内往往频繁失败，哪怕设置 hosts 或使用一些优化方法后，也可能出现不稳定的情况。究其根本，问题还是网络连接国外源，不易彻底解决。

二、最佳安装策略：直接使用国内镜像（极力推荐⭐️⭐️⭐️⭐️⭐️）

在反复测试后，我们发现目前最有效、最简单的方式，就是直接使用国内镜像！

目前国内最主流、最稳定的镜像（中国科学技术大学镜像源）已有一键安装脚本，配置简单，安装迅速。

核心理由：

  • 国内镜像速度极快，安装一气呵成。

  • 一次安装，永久解决国内网络问题，后续更新、升级都快速省心。

三、安装步骤 (超简单！三步搞定 🎉)

第一步：卸载失败/已损坏安装的brew（如果之前安装失败且有残留文件）

为了确保下一步安装干净彻底，先执行一次卸载操作：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

⚠️ 如果出现失败（可能因为安装不完整），手动强行删除 Homebrew 文件夹即可：

sudo rm -rf /opt/homebrew

第二步：使用国内镜像脚本一键安装Homebrew（中科大镜像🌟）

终端运行：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

此脚本经过无数国内开发者反复验证，安全性和稳定性无需担忧：

  • 自动使用中国科学技术大学镜像源安装

  • 自动完成镜像源配置，不需额外手动修改

  • 安装过程快速高效，基本1-3分钟即可搞定 🎯

第三步：安装软件测试（以Node.js为例）

安装好brew后，直接测试安装node：

brew install node

检查 Node.js 成功安装：

node -v

npm -v

出现版本正常即安装成功。一切顺利！

四、后期维护：自动更新与其他软件安装

以后维护非常容易，brew 会自动访问中科大镜像源，对广大开发者非常友好。

很简单地，每隔一段时间，终端执行一次：

brew update

brew upgrade

即可更新 Homebrew 覆盖的软件包。

安装其他软件方法依然非常简单，速度超快：

例如安装python：

brew install python

安装Git：

brew install git

和之前brew用法完全一样，毫无门槛，只是网速明显改善。

五、推荐理由总结 👍

  • ✅ 一步到位解决国内brew安装难题。

  • ✅ 安装配置一次搞定，无须后续折腾。

  • ✅ 长期稳定高效，国内镜像维护及时且规模大。

🎁 写在最后：

以上方法经过反复的实践和验证，是我亲测最有效的（截至2025年）。我个人认为“直接使用国内镜像源安装Homebrew”这种方案，对国内mac用户几乎是必备技巧。

希望此文能帮助到更多的开发者朋友！

快去试一下吧，真的超级有效～ 😄

### 🔖 推荐镜像源致谢：

本文推荐的镜像源来自 中国科学技术大学开源软件镜像站 和 HomebrewCN开源项目。

镜像主页：https://mirrors.ustc.edu.cn

brew脚本Git仓：https://gitee.com/cunkai/HomebrewCN

🎯 最终效果：

从此再无brew安装难题，一切丝滑顺畅！🍀🚀