Homebrew
是一款包管理工具,目前支持macOS
和linux
系统。主要有四个部分组成: brew
、homebrew-core
、homebrew-cask
、homebrew-bottles
。
名称 | 说明 |
---|---|
brew | Homebrew 源代码仓库 |
homebrew-core | Homebrew 核心源 |
homebrew-cask | 提供 macOS 应用和大型二进制文件的安装 |
homebrew-bottles | 预编译二进制软件包 |
本文主要介绍Homebrew
安装方式以及如何加速访问,顺便普及一些必要的知识。
如果你需要在M1
芯片的Mac
上安装Homebrew
,可以先阅读下这篇文章:
如果安装过程中遇到问题,可以通过下面方式获得联系:
本教程拥有自己的主页啦,你可以获得更好的阅读体验,赶紧点此访问吧。
1. 写在前面
curl: (7) Failed to connect to raw.githubusercontent.com port 443: Operation timed out
使用官方脚本遇到上面的错误提示:请按照下面「安装步骤」步骤执行。
官方脚本无法使用的原因是
raw.githubusercontent.com
访问很不稳定,可以采用写入hosts
的方式,可以一定程度解决GitHub
资源无法访问的问题,我也写了一篇操作文章,有需要可以阅读下。
2. 安装步骤
默认使用中科大源,如果需要更换,请使用 镜像助手 获取执行脚本。
安装脚本:
/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
成功执行之后继续执行前文的安装命令:
/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install.sh)"
最后看到==> Installation successful!
就说明安装成功了。
需要注意,如果是m1则需要手动设置环境变量,请注意看终端输出的中文提示信息,会以下面文字开头。
"切记执行环境变量设置!,如已执行过请忽略。"
最后更新下:
brew update
🎉 恭喜Homebrew
安装完成了!
3. 如何设置镜像
必读!!!
这个章节主要针对已经安装过Homebrew
,但是需要设置镜像的情况。
如果是全新安装,只需要设置3.3的bottles
镜像。
3.1 中科大源
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
3.2 清华大学源
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
更多可选源请访问镜像助手。
3.3 设置bottles镜像
设置环境变量需要注意终端Shell
的类型,请看下面说明:
镜像以中科大源为例。
从macOS Catalina
(10.15.x) 版开始,Mac
使用zsh
作为默认Shell
,对应文件是.zprofile
,所以命令为:
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zprofile
source ~/.zprofile
如果是macOS Mojave
及更低版本,并且没有自己配置过zsh
,对应文件则是.bash_profile
:
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile
注意:上述区别仅仅是
.zprofile
和.bash_profile
不同,文章如有再次提及编辑.zprofile
,均按此方法替换。
如果想使用清华源:
把
https://mirrors.ustc.edu.cn/homebrew-bottles
替换为
https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
至此,安装和设置操作都完成了。
3.4 如何恢复默认源
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
。
4. 其他相关
4.1 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
下载软件,所以目前是无法加速的。
4.2 如何卸载Homebrew
使用官方脚本同样会遇到uninstall
地址无法访问问题,可以使用下面脚本:
/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/uninstall.sh)"
4.3 反馈问题
5. 总结
在前面的过程中我们把brew
和homebrew-core
的地址都指向到中科大镜像。
原理是通过修改install.sh
脚本,在里面预设镜像地址。
STAT="stat --printf"
CHOWN="/bin/chown"
CHGRP="/bin/chgrp"
GROUP="$(id -gn)"
TOUCH="/bin/touch"
fi
# 这里替换了BREW_REPO
BREW_REPO="https://mirrors.ustc.edu.cn/brew.git"
如果对您有帮助
点赞、分享、收藏,能让更多人能发现文章,这也是对我的认可和鼓励,谢谢。
参考文章
📣 广告插播
GitMaster
可以树形展示git
项目代码。
- 🚀 代码树支持
GitHub
、GitLab
、Gitee
、Gitea
、Gogs
- 🖊️ 支持私有部署页面,一键标记
- 🗂️ 文件提交历史可视化
git history
- 🔔
GitHub
通知提醒功能 - ⬇️ 支持
GitHub
文件、目录下载
安装
商店安装
FAQ
大部分问题都是资源不稳定导致的,如果可以的话尽量通过代理加速。
代理使用可以参考以下文章:
完整版问题排查内容请访问FAQ,以便获得强有力的支持。
No.1 的小秘籍
遇到解决不了的问题,先删除homebrew
目录再重新运行脚本安装。
- x86 上安装目录:
/usr/local/Homebrew/
- arm 上安装目录:
/opt/homebrew
fatal: unable to access xxx
HEAD is now at 028e733e7 Merge pull request #10260 from reitermarkus/audit-livecheck
fatal: unable to access 'https://github.com/Homebrew/homebrew-core/': transfer closed with outstanding read data remaining
fatal: ambiguous argument 'refs/remotes/origin/master': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'
解决方案:
- 根据文章解决GitHub网页githubusercontent地址无法访问问题,给
github.com
域名加速 - 通过代理访问
设置镜像无效,安装还是很慢
这里说的安装很慢主要是指brew
本身安装速度慢(镜像地址没有设置成功)。
可以执行命令echo $SHELL
,先查看终端类型。
- bash:
/bin/bash
- zsh:
/bin/zsh
然后根据终端类型设置镜像,参考"设置镜像"。
command not found: brew
一般是环境变量无效,请使用echo $SHELL
确认终端类型,参考上节。
m1
芯片Mac
电脑需要手动设置环境变量:
zsh
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.bash_profile
eval "$(/opt/homebrew/bin/brew shellenv)"
非m1
的话,可以尝试手动加入环境变量:
zsh
echo 'eval "$(/usr/local/Homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/Homebrew/bin/brew shellenv)"
bash
echo 'eval "$(/usr/local/Homebrew/bin/brew shellenv)"' >> ~/.bash_profile
eval "$(/usr/local/Homebrew/bin/brew shellenv)"