homebrew 安装 formula 的不同历史版本——以安装 node 为例
homebrew 安装 formula 的不同历史版本——以安装 node 为例
系统环境
- macOS Mojave 10.14
- Homebrew 1.8.0
Homebrew/homebrew-core (git revision 586b0f; last commit 2018-10-27)
Homebrew/homebrew-cask (git revision 76ddc; last commit 2018-10-27)
背景
最近 nodejs 发布了 11.0.0 版本,而我是用 brew 安装了名为 node 的这个 formula ,现在 brew upgrade
会自动将 node 更新到最新版本,于是我遇到了一些问题:
- 一些需要编译安装的依赖包还不支持 node@11 ;
- 不知道如何自动切换两个 formula ( node 和 node@10 )之间的可执行文件;
- 是否能够设定某个 formula 不自动更新?
在经过一番折腾后,现在我删掉了 node 和 node@10 两个 formula ,包括之前安装的历史版本(所以算是多走了一点弯路),想要同时保留 10 和 11 两个大版本,并可方便切换。
前置条件
若下列条件不满足,可能导致需要额外的操作来解决环境问题,这些操作不在本文讨论范围内:
- 只通过 homebrew 来安装 node ;
- 没有使用如 n / nvm 等 node 版本管理工具;
- 某种意义下连接性良好的网络。
适用情况
本文覆盖了如下四种情况:
- 某个 formula 跟随着更新上来,没有运行过 cleanup 或 force uninstall ,想切回旧版本的(见关键点三);
- 全新安装且只想安装某个 formula (如 node 而非 node@10 ),但又想先用着旧版本的(见解决方案一);
- 某个 formula 在用的是旧版本,但想切换编译选项(如
--with-openssl@1.1
)重新安装(同上); - 在两个 formula 之间切换,如一个是 LTS 版的,一个是不稳定版的(见解决方案二)。
关键点
如何在 brew install / upgrade 时禁止自动更新
这一步很关键,否则我们总是会安装到最新版本。只要在运行命令前,设置环境变量 HOMEBREW_NO_AUTO_UPDATE 为 1 就可以了,比如:
$ HOMEBREW_NO_AUTO_UPDATE=1 brew install node
也可以直接写进 shell 配置文件中(如 .bashrc / .zshrc 等):
export HOMEBREW_NO_AUTO_UPDATE=1
查看某个 formula 的本地已安装版本
有两种方式可查看,一是 brew list --versions
,输出以空格分隔,简洁明了,推荐使用:
$ brew list node --versions
node 11.0.0 10.12.0
$ brew list zsh --versions |tr ' ' '\n'
node
11.0.0
10.12.0
二是 brew info
在查看 formula 信息时也可看到本地已安装的版本:
$ brew info node
$ brew info node |grep -i '\/cellar'
/usr/local/Cellar/node/10.12.0 (3,668 files, 41.7MB)
/usr/local/Cellar/node/11.0.0 (3,665 files, 42MB) *
后面带有的星号 * 表示当前激活的版本。
切换某个 formula 的版本
自有的 brew switch
命令即可,之前感觉 brew 较易上手,安装后没看文档直接用到现在,所以不知道这个命令。命令的说明也很直观:
brew switch formula version:
Symlink all of the specific version of formula's install to Homebrew prefix.
直接键盘一顿敲就行了,如 brew switch node 10.12.0
。
解决方案
安装某个 formula 的历史版本
-
切换到 brew 的仓库目录下
$ cd "$(brew --repo homebrew/core)"
-
查看某个 formula 的 git 历史记录
$ git log master -- Formula/node.rb
在里面找到想要的历史版本,比如这个就挺像我所需要的:
commit b801cc6b71e7c09448b4f823e493710665de68eb Author: BrewTestBot <homebrew-test-bot@lists.sfconservancy.org> Date: Thu Oct 11 00:12:43 2018 +0000 node: update 10.12.0 bottle.
-
检出 git 历史提交
$ git checkout b801cc6b71e7c09448b4f823e493710665de68eb
-
在禁止自动更新的前提下安装这个 formula
$ HOMEBREW_NO_AUTO_UPDATE=1 brew install node --with-openssl@1.1
-
由于刚才第 3 步后处于分离头指针状态下,记得要切回来
$ git checkout master
-
升级这个 formula 试试
$ brew upgrade node
-
检查当前版本,应该是最新的,现在再把它切回来
$ node -v v11.0.0 $ brew switch node 10.12.0 Cleaning /usr/local/Cellar/node/10.12.0 Cleaning /usr/local/Cellar/node/11.0.0 7 links created for /usr/local/Cellar/node/10.12.0 $ node -v v10.12.0
在两个 formula 之间切换
我们也可以在 node 和 node@10 两个 formula 之间切换文件链接。但是注意,这种方法可能会在运行 brew doctor
时产生警告,因为可能会有一个不是 keg-only 的包没有被链接到 Cellar 中(如为了使用 node@10 而解除了 node 的链接),这个警告可以不去理会,但必须记住我们做过这样的操作。
-
假定已经安装了 node ,现在安装 node@10 ,键盘一顿乱敲
$ brew install node@10
通常像这样名字后面带有版本号的 formula 都是 keg-only 的,简单来说就是 brew 不会自动帮我们链接文件
-
先解除 node 的文件链接
$ brew unlink node
-
链接 node@10 的文件
$ brew link node@10
这时会提示这个包是 keg-only 的,需要加上
--force
选项。如果第 2 步没有进行,还会提示你需要先解除 node 的链接,或者直接用--overwrite
选项覆盖原有的链接。由于 npm 目录一定需要覆盖,所以我们总是可以打开--overwrite
选项:$ brew link node@10 --force --overwrite
-
检查当前版本,在解决方案一中提到过了,方法也有很多种,此处略过。
后续问题
-
全局安装的包支持的 node 版本可能不同
是的,这个问题一定会存在,建议通过切换 npm prefix 路径解决,把不同版本 node 下安装的全局包隔离开来。当然 nvm 等方案也可以解决问题,但本文是不一样的烟火。$ mkdir -p ~/.npm-node10/npm-global $ npm config set prefix ~/.npm-node10/npm-global $ export PATH="$HOME/.npm-node10/npm-global/bin:$PATH"
手动切换确实比较繁琐,可以写个 shell 脚本把切换 formula 和切换 npm prefix 结合起来。
-
如何固定某个 formula 的版本?
虽然说不运行brew upgrade
就一直是固定的版本,但如果想只固定某个 formula 的版本而允许其他可以升级,也是极好的。自带的 pin 、 unpin 命令就是用来解决这一问题,如:brew pin node
。 -
如何删除某个 formula 的旧版本?
尽管brew cleanup
可以删除一个 formula 的所有旧版本,但通常我们可能只想删除某几个太旧且多余的版本而不是全部。 brew 没有提供这样的命令,我们可以直接从 Cellar 里面删除:$ brew info node |grep -i '\/cellar' /usr/local/Cellar/node/10.12.0 (3,668 files, 41.7MB) /usr/local/Cellar/node/11.0.0 (3,665 files, 42MB) * $ rm -rf /usr/local/Cellar/node/10.12.0
初步测试未发现有副作用,欢迎讨论和建议。
-
如何在升级时自动删除旧版本?
根据brew upgrade
命令的说明,设置一个 HOMEBREW_UPGRADE_CLEANUP 环境变量就好了,比较简单。
参考资料
- Tips and Tricks - Homebrew Documentation
- Homebrew terminology - Homebrew Documentation
- FAQ - Homebrew Documentation
- homebrew - how to install older versions - Stack Overflow
- Homebrew install specific version of formula? - Stack Overflow
- Using Homebrew how do I remove some specific versions but not all old versions - Stack Overflow
本文基于 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 发布,欢迎引用、转载或演绎,但是必须保留本文的署名 BlackStorm 以及本文链接 http://www.cnblogs.com/BlackStorm/p/homebrew-install-old-versions-take-node-for-example.html ,且未经许可不能用于商业目的。如有疑问或授权协商请与我联系。