快速开始

如果你是在M1芯片的Mac上安装Homebrew,请参考 M1 芯片安装教程

安装说明

如果之前尝试过其他脚本安装,请移除Homebrew后再安装,具体请参考 FAQ

/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install.sh)"

默认使用中科大源,如果需要换源参考 换源

如果命令执行中卡在下面信息:

==> Tapping homebrew/core
Cloning into '/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core'...

Control + C中断脚本执行如下命令:

cd "$(brew --repo)/Library/Taps/"
mkdir homebrew && cd homebrew
git clone git://mirrors.ustc.edu.cn/homebrew-core.git

安装cask 同样也有安装失败或者卡住的问题,解决方法也是一样:

cd "$(brew --repo)/Library/Taps/"
cd homebrew
git clone https://mirrors.ustc.edu.cn/homebrew-cask.git

成功执行之后继续执行安装命令。

最后看到==> Installation successful!就说明安装成功了。

最最后更新下:

brew update

设置镜像

更新:强烈建议使用 镜像助手 ,你可以自助获取镜像脚本,目前支持中科大、清华、腾讯、北京外国语镜像源。

中科大源

git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
brew update

清华大学源

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
brew update

设置 bottles 镜像

设置环境变量需要注意终端的类型,可以先通过以下方式获取:

执行命令echo $SHELL,根据结果判断:

  • /bin/zsh => zsh => .zprofile
  • /bin/bash => bash => .bash_profile

然后继续正式操作,以中科大源为例:

macOS Catalina(10.15.x) 版开始,Mac使用zsh作为默认Shell,对应文件是.zprofile,所以命令为:

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

如果是macOS Mojave 及更低版本,并且没有自己配置过zsh,对应文件则是.bash_profile

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles/bottles' >> ~/.bash_profile
source ~/.bash_profile

注意:上述区别仅仅是.zprofile.bash_profile不同,上下文如有再次提及编辑.zprofile,均按此方法判断具体操作的文件。

至此,安装和设置操作都完成了。

恢复默认源

git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git
brew update

homebrew-bottles配置只能手动删除,将 ~/.zprofile 文件中的 HOMEBREW_BOTTLE_DOMAIN=https://mirrors.xxx.com内容删除,并执行 source ~/.zprofile

如何卸载 Homebrew

使用官方脚本同样会遇到uninstall地址无法访问问题,可以使用下面脚本:

/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/uninstall.sh)"

其他相关

cask

目前cask是从GitHub上读取软件源,而GitHub Api对访问有限制,如果使用比较频繁的话,可以申请Api Token,然后在环境变量中配置到HOMEBREW_GITHUB_API_TOKEN

.zprofile中追加,注意替换yourtoken:

echo 'export HOMEBREW_GITHUB_API_TOKEN=yourtoken' >> ~/.zprofile
source ~/.zprofile

注意:因为cask是从GitHub下载软件,所以目前是无法加速的。

反馈

非常欢迎你来尝试使用,并提出意见,你可以通过以下方式:

  • 通过 Issue 报告 bug 或进行咨询
  • 微信群(见下图)
  • 提交 Pull Request 改进文档
湖中剑-homebrew

如果安装遇到问题,强烈建议先通过 FAQ 自查,新问题的解决方案会持续更新。

如果对您有帮助

您可以考虑请我喝杯咖啡。

当然分享、收藏,能让更多人能发现文章,这也是对我的认可和鼓励。

wechat-reward-code-zh.jpg

参考文章

需要帮助?
建议先查阅 FAQ
扫码回复"brew"进群