homebrew官网,有安装教程提示,但是在实际安装时,由于待下载的包的尺寸过大,本地git缓存尺寸、超时时间的限制,会报如下错误:
error: RPC failed; curl 92 HTTP/2 stream 5 was not closed cleanly:CANCEL
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
一、安装
执行命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
二、git设置
macos在安装时可能会遇到如上述的报错,可以增加以下设置
1. 增加 git 的缓冲区大小
增大 Git 缓冲区可以帮助解决传输中断问题:
git config --global http.postBuffer 524288000
2. 调整 Git 的传输超时
可以通过增加 Git 的超时时间来防止网络不稳定引起的中断:
git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 999999
3. 使用浅克隆
如果你在克隆 Homebrew 的仓库,可以使用浅克隆来减少传输的数据量:
git clone --depth=1 https://github.com/Homebrew/brew.git
设置完成后,git配置如下:
4. 尝试使用镜像源
执行上述安装脚本时,走到Updating brewing
时,可能会出现如下报错:
Error: Failed to download https://formulae.brew.sh/api/formula.jws.json!
看到这个报错时,基础功能已经安装成功,可能是网络问题,连接 Homebrew 官方服务器可能不稳定,特别是在中国等网络环境受限的地区。可以尝试使用国内镜像源。
设置国内源(例如清华大学的镜像):
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git
1、如果提示
brew
命令行不存在,那么请先按照下面第2节,配置brew的bin文件到环境变量Path中,brew
命令行就能生效。然后再执行上述命令,去修改源。
2、如果报如下错:
fatal: cannot change to '/opt/homebrew/Library/Taps/homebrew/homebrew-core': No such file or directory
,则表示Homebrew 核心库(homebrew-core)没有正确安装,可以先手动安装:
# 创建 Homebrew taps 目录
mkdir -p "$(brew --repo)/Library/Taps/homebrew"
# 克隆 homebrew-core 仓库到本地
git clone https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
3、如果报如下错:
fatal: cannot change to '/opt/homebrew/Library/Taps/homebrew/homebrew-cask': No such file or directory
,则表示Homebrew 核心库(homebrew-cask)没有正确安装,可以先手动安装:
# 创建 Homebrew Taps 目录
mkdir -p "$(brew --repo)/Library/Taps/homebrew"
# 克隆 homebrew-cask 仓库到本地
git clone https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git "$(brew --repo)/Library/Taps/homebrew/homebrew-cask"
2. 确认 Homebrew 安装路径
如果安装成功,但 brew 命令依然无法找到,可能是 Homebrew 的路径没有正确配置。首先,检查 Homebrew 是否已经安装并找到安装路径。
在 Apple Silicon Mac 上,Homebrew 通常会安装在 /opt/homebrew
,而在 Intel Mac 上,通常会安装在 /usr/local
. 你可以手动添加 Homebrew 的路径到你的 PATH
环境变量中。
2.1. (M1/M2) 芯片Mac:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
2.2. Intel 芯片Mac:
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"
然后,重新启动终端或执行以下命令以重新加载配置:
source ~/.zprofile
3. 验证 Homebrew 安装
在重新安装并配置 PATH 之后,运行以下命令检查 Homebrew 是否安装成功:
brew --version
如果你看到 Homebrew 的版本信息,说明安装成功并配置正确。
成功后,显示如下: