RUNBOOK / Homebrew
Homebrew 卡在 Updating Homebrew：安全跳过与恢复更新
brew install 长时间停在 Updating Homebrew，终端没有明显进度。
故障现象与判断依据
最可能原因
常见根因是 git remote、DNS、受限网络或自动更新等待，不是公式本身坏了。
LOG==> Updating Homebrew...
$ brew update --debug
# 保留完整 Git 与网络输出安全诊断
以下命令用于读取状态、验证解析或复现请求；先确认目标主机、权限与影响范围。命令中的占位符必须替换为当前环境的实际值。
READ / VERIFYHOMEBREW_NO_AUTO_UPDATE=1 brew install <formula>
brew config
git -C "$(brew --repo)" fetch --verbose推荐修复步骤
- 1使用 brew update --debug 确认卡在 Git、DNS 还是下载阶段。
- 2仅为当前命令设置 HOMEBREW_NO_AUTO_UPDATE=1，避免盲目全局禁用。
- 3检查 brew config 与 git remote -v，恢复官方或组织规定的镜像。
验证、限制与回滚
修复后的验证
brew update 和 brew doctor 成功，后续 install 有明确下载进度。
风险提示与回滚
不要以关闭证书校验、删除全部缓存、无限重试、关闭防火墙或放宽到 chmod 777 来替代根因定位。任何配置变更前先保留原文件和校验结果；若验证失败，恢复该备份并重新采集日志。
可信来源与适用边界
参考来源brew outdated: output format now varies between runs · Issue #20976 · Homebrew/brew · GitHub ↗
==> Updating Homebrew 此页将环境级案例与本 Runbook 的检查步骤分开呈现，不能把示例日志当作当前服务器的真实事件。
网络环境检测
当 DNS、代理链路、海外依赖源或下载超时已通过本页命令确认是网络层问题时，可继续核对独立网络服务；这不替代本地根因修复。
访问边界云官方网站 →具体套餐、价格、可用线路、服务内容及相关规则以官网当前页面为准；不会携带你在工作台输入的命令、日志、Token、IP 或邮箱。