Homebrew 卡住不动？试试这个“混搭”大法救急

作为 macOS 用户，Homebrew 绝对是装机必备的神器，但相信大家也遇到过那种让人崩溃的时刻：兴致勃勃地敲下 brew update 或者 brew upgrade，结果半天没反应，要么就是报一堆看不懂的错误代码，进度条仿佛永远卡在 99%。

最近我发现了一个比较好玩的“混搭”思路，专门对付这种因为网络环境或者索引不一致导致的抽风现象。这不算是什么官方正规解法，但在实际使用中，很多时候效果比单纯的删库重装要快得多，今天就来分享给大家。

为什么会卡住？

在教方法之前，先简单唠叨两句原理。Homebrew 的机制本身就是去 GitHub 或者上游源拉取最新的 Formula 和 Core 索引。对于国内用户来说，网络波动是最大的拦路虎。有时候部分包拉下来了，部分的没下来，导致本地索引处于一种“既不完全旧，也不完全新”的半死不活状态，这时候再执行命令，它就会陷入死循环或者直接报错。

“混搭”急救法

既然单一命令容易在某个环节卡壳，那我们就手动拆解一下步骤，配合强制刷新来试试。请按照以下顺序在终端中依次执行，这一套组合拳下来，基本能解决 80% 的抽风问题：

第一步：清理缓存并尝试重置 git 仓库状态 有时候 brew 的本地 git 仓库状态异常是最头疼的。我们先尝试进入 Homebrew 的目录手动重置一下（当然，如果你改过默认安装路径，下面的 cd 路径记得换成你自己的）：

cd $(brew --repo) && git fetch && git reset --hard origin/master && cd -

这行命令的作用是强制把本地的核心库回退到远程主分支的最新状态，不管你本地之前改了什么或者烂成什么样，先强制同步再说。

第二步：手动更新 Homebrew 自身 做完上面的步骤，我们先别急着去装软件，先确保 Homebrew 自身是最新且健康的：

brew update

如果这一步依然卡住，可以尝试加上 --verbose 参数看看到底卡在哪一步，或者临时切换到中科大、清华大学等国内镜像源（这里就不展开镜像源配置了，那是另一个大话题）。

第三步：清理并安装/升级 这就是所谓的“混搭”精髓。为了避免升级过程中因为依赖冲突或者旧版本残留导致的问题，我习惯在升级前做一次清理，然后再执行升级：

brew cleanup && brew upgrade
``n
如果 `brew upgrade` 还是在报错，甚至可以尝试单独升级出问题的那个包，或者加上 `--force` 强制重新安装依赖：

```bash
brew reinstall <package_name>

避坑小贴士

1. 不要太迷信强制命令：虽然 git reset --hard 很暴力，但如果你自己修改过 Homebrew 的核心配置文件（这种情况虽然少见，但也存在），这操作会让你辛苦的修改付诸东流，所以操作前最好心里有数。
2. 镜像源是王道：如果上述方法试了一遍还是慢得像蜗牛，那真的不是命令的问题，请老老实实去搜索一下如何配置国内镜像源。网络通顺了，brew 才能起飞。
3. 权限问题：偶尔报错并不是网络问题，而是 /usr/local 或者 /opt/homebrew 目录的读写权限问题。如果命令提示 Permission denied，记得检查一下文件夹归属，必要时可以用 sudo chown -R $(whoami) ... 修复权限（但在 Apple Silicon Mac 上，/opt/homebrew 通常不需要 sudo）。

希望这个“混搭”大法能帮你节省下在那看着进度条发呆的时间。如果你有更野的路子或者遇到了什么奇葩报错，欢迎在评论区交流，咱们一起避坑！