Mac安装Homebrew反复失败,出现git fetch相关报错该如何解决?
Homebrew 安装git fetch中断报错解决方案
这个报错的核心原因是Homebrew核心仓库体积较大,网络拉取过程中出现中断,和本地设备重置与否没有关联,可通过以下方法解决:
方案1:调整Git全局参数
- 增大Git传输缓存,避免大文件拉取时缓存溢出:
git config --global http.postBuffer 524288000 - 关闭Git低速自动断连机制,适配不稳定网络:
git config --global http.lowSpeedLimit 0git config --global http.lowSpeedTime 999999
配置完成后重新运行Homebrew安装命令即可。
方案2:使用国内镜像源安装
如果是网络访问GitHub受限导致的断连,可临时指定国内镜像源进行安装:
- 先在终端执行以下命令配置临时环境变量:
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git" export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git" export HOMEBREW_INSTALL_FROM_API=1
- 再运行Homebrew官方安装脚本,安装过程会自动从国内镜像拉取资源,不会出现断连问题。
- 若需后续长期使用国内源,可将上述三条命令写入你的Shell配置文件(
~/.zshrc或~/.bash_profile)中,永久生效。
方案3:手动浅克隆核心仓库
如果上述方案均不生效,可手动拉取核心仓库跳过安装过程中的自动拉取步骤:
- 运行安装脚本至报错停止后,进入Homebrew的Taps目录:
cd "$(brew --repo)/Library/Taps/homebrew" - 删除已生成的不完整核心仓库目录:
rm -rf homebrew-core - 使用浅克隆方式拉取核心仓库,仅拉取最新提交减少拉取体积:
git clone --depth=1 https://github.com/Homebrew/homebrew-core.git
拉取完成后重新运行安装脚本即可完成后续安装步骤。
后续包安装异常修复
安装完成后如果出现mongoose等类库无法安装的问题,先执行Homebrew自检命令修复异常:brew doctor
按照终端输出的提示完成对应修复即可,通常为仓库权限或源配置类问题。
内容的提问来源于stack exchange,提问作者charlietlamb
相关产品推荐
相关产品推荐

