说实话，作为一个在代码堆里摸爬滚打多年的开发者，每次换新电脑或者重装系统，Zui让我头疼的不是配置IDE，也不是迁移数据，而是那个kan似简单却暗藏杀机的 Homebrew 安装过程。你有没有过这种经历？满怀信心地敲下官方推荐的一行安装命令，然后盯着屏幕上那个一动不动的光标，心里默念“快啊，动啊”，结果几分钟后屏幕上冷冰冰地弹出一行 Failed to connect 或者 Connection timed out。那种感觉，真的，就像是一拳打在了棉花上，无力又抓狂。

咱们国内的网络环境，大家dou懂的。GitHub 的访问速度时快时慢，完全kan运气。而 Homebrew 的核心资源全dou托管在 GitHub 上，这就导致直接使用官方脚本安装，成功率低得令人发指。别灰心，今天我就把压箱底的经验拿出来手把手教你如何利用国内镜像源，顺顺利利地把这个“macOS 上不可或缺的包管理神器”请进你的电脑。

为什么官方安装总是“卡脖子”？

在开始动手之前，咱们得先明白问题出在哪。Homebrew 的官方安装脚本非常简洁，本质上就是去 GitHub 上拉取代码。但是由于众所周知的原因，raw.githubusercontent.com 这个域名在国内经常处于抽风状态。有时候Neng连上，速度却只有几KB/s，有时候直接就断连了。这就好比你明明家门口就有超市，非得绕地球一圈去进货，Neng不慢吗？

所以我们的核心思路就是：换路！ 既然去 GitHub 的路不好走，那我们就去国内的“中转站”拿货。目前国内几个顶尖的高校和云服务商dou提供了非常稳定的镜像源，比如清华大学 TUNA 协会、中科大开源软件镜像站等等。这些镜像站会定期同步 GitHub 上的内容，我们在国内访问它们的速度，那叫一个飞快，简直就像从自家硬盘读取一样丝滑。

准备工作：别让小细节绊倒你

在正式开搞之前，有几个小细节得先确认一下免得Zuo到一半报错，搞得心态崩了。

你得确保你的 Mac 上安装了 Xcode 的命令行工具。虽然我们不一定需要那个硕大的 Xcode IDE，但是编译一些软件时需要的编译器链是必须的。打开终端，输入以下命令：

xcode-select --install

Ru果系统提示你Yi经安装了那就直接跳过；Ru果弹窗让你安装，那就乖乖点安装，泡杯茶等一会儿。这一步是基础中的基础，千万别偷懒。

方法一：懒人福音——使用 Gitee 的一键安装脚本

Ru果你不想折腾那些复杂的 Git 命令，或者对环境变量配置感到头大，那么这个方法绝对适合你。国内有大神把官方的安装脚本Zuo了魔改，把所有的下载源dou指向了国内，并且托管在了 Gitee 上。

直接在终端里复制粘贴下面这行命令，然后回车：

/bin/zsh -c "$"

执行之后你会kan到一个交互式的菜单。脚本会让你输入密码。然后它会让你选择镜像源，一般推荐选择中科大或者清华大学的源，这两个速度Zui稳。

接下来你就Ke以kan着进度条欢快地跑起来了。脚本会自动帮你处理 homebrew-corehomebrew-cask 这些核心库的下载，还会自动帮你配置好环境变量。对于新手来说这简直是“救命稻草”，全程无脑操作，成功率极高。

方法二：极客范儿——手动配置镜像源

当然有些朋友可Neng跟我一样，喜欢掌控一切，不喜欢用别人写好的“黑盒”脚本。或者你想geng深入地了解 Homebrew 的运作原理，那么手动安装法虽然步骤多一点，但Neng让你心里geng有底。

1. 下载官方安装脚本并修改

我们还是要把官方的安装脚本拿下来。不过别急着执行，先把它存到本地。

curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh -o install.sh

Ru果这步dou卡住了那你可Neng得先挂个梯子，或者直接用方法一吧。假设你下载下来了用编辑器打开这个 install.sh 文件。你需要找到里面定义 BREW_REPO 和 CORE_REPO 的地方，把原本指向 GitHub 的地址，改成中科院或者清华的镜像地址。比如把 github.com 替换成 mirrors.tuna.tsinghua.edu.cn/git/homebrew。这一步有点像是在给赛车换轮胎，虽然麻烦，但换完之后跑得飞快。

2. 设置环境变量并执行

geng优雅的Zuo法是在执行安装脚本之前，先在终端里通过环境变量告诉系统：“嘿，别去 GitHub 了去清华那拿！”

你Ke以像下面这样设置环境变量：

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

设置完这些，再去运行官方的安装命令，脚本就会乖乖地去你指定的镜像站拉取数据了。是不是感觉hen有掌控感？

安装后的“临门一脚”：配置环境变量

不管你是用方法一还是方法二，安装完成后千万别急着关掉终端。hen多人以为装完了就万事大吉，结果一敲 brew 命令，系统提示 command not found，瞬间心态爆炸。这其实是因为 Homebrew 的路径还没有加到系统的 PATH 里去。

这里有个大坑，就是 Apple Silicon的 Mac 和 Intel 芯片的 Mac，安装路径是不一样的！

Ru果你用的是 M1 或geng新的芯片，Homebrew 默认是装在 /opt/homebrew 下的；而 Intel 芯片的老款 Mac 则是在 /usr/local。别搞混了不然怎么配dou不对。

以现在Zui常见的 M 系列芯片为例，你需要编辑你的 shell 配置文件。现在 macOS 默认用的是 zsh，所以我们要编辑 ~/.zprofile

vim ~/.zprofile

按 i 进入编辑模式，在文件末尾加上这一行：

export PATH="/opt/homebrew/bin:$PATH"

按 ESC，输入 :wq 保存退出。然后Zui重要的一步，让配置生效：

source ~/.zprofile

这时候，你再输入 brew -v，Ru果屏幕上乖乖地显示了版本号，恭喜你，大功告成！那种如释重负的感觉，简直比喝了冰可乐还爽。

给 Homebrew 换个“加速引擎”：配置 Bottles 镜像

安装好只是第一步，平时我们用 brew install 装软件的时候，其实大部分时间是在下载二进制包，也就是所谓的 Bottles。Ru果你不配置这个的镜像，哪怕你安装的时候用了镜像，平时下载软件还是会去 GitHub 上拖，速度依然感人。

所以为了长久的幸福，我们Zui好把 Bottles 的源也换了。刚才手动安装的时候其实Yi经提到了一个环境变量 HOMEBREW_BOTTLE_DOMAIN。Ru果你当时没设，现在补上也不迟。

对于 zsh 用户，直接在终端执行：

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles'>> ~/.zprofile
source ~/.zprofile

这一步就像是给你的 Homebrew 装了个涡轮增压，以后下载 gitnodepython 这些大家伙，速度直接起飞。

常见问题排雷：遇到坑怎么办？

虽然有了镜像，但有时候还是会遇到一些奇奇怪怪的问题。别慌，咱们一个个来拆解。

1. 执行 brew 命令报错 404

Ru果你在执行 brew update 或者安装软件时遇到 404 错误，大概率是你之前设置的镜像源挂了或者路径不对。这时候Ke以先尝试重置回官方源kankan是不是软件本身的问题，或者换一个镜像源试试。比如清华源不行，就换中科大的源。

2. 权限问题

有时候报错会提示你没有权限。这时候千万别一怒之下用 sudo 去强行操作。Homebrew 本身设计就是为了避免使用 sudo 的。Ru果遇到权限问题，通常是 /usr/local 或者 /opt/homebrew 目录下的文件归属不对。Ke以用 chown 命令把目录的所有权改回当前用户。

3. Git 报错

Homebrew 底层是靠 Git 来管理的。Ru果你没装 Git，或者 Git 版本太老，也会出问题。不过一般只要你装了 Xcode Command Line Tools，Git dou是现成的。Ru果报错说找不到 Git，那就去 brew.sh 上kankan怎么装个新版的 Git。

享受丝滑的开发体验

折腾了这么一大圈，其实目的只有一个：让我们在写代码、装工具的时候，少一点等待，多一点效率。Homebrew 确实是个好东西，一旦你习惯了那种 brew install 一行命令搞定一切的爽快感，你就再也回不去那个到处百度找安装包、手动配置环境变量的旧时代了。

虽然在国内环境下我们不得不多走几步路去配置镜像，但这何尝不是一种“磨刀不误砍柴工”呢？当你kan着终端里飞速滚动的日志，几秒钟就装好了一个复杂的开发环境，那一刻的成就感，绝对值得你刚才付出的努力。

希望这篇教程Neng帮到还在被安装速度折磨的朋友们。Ru果觉得有用，别吝啬你的点赞和收藏，顺便转发给身边还在“卧槽，怎么又连不上”的基友们。毕竟独乐乐不如众乐乐嘛！下次遇到网络问题，别再对着屏幕发呆了换个镜像，世界瞬间清净。

---