homebrew 安装 formula 的不同历史版本——以安装 node 为例
2019-08-28

homebrew 安装 formula 的不同历史版本——以安装 node 为例

系统环境

macOS Mojave 10.14Homebrew 1.8.0Homebrew/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 --versionsnode 11.0.0 10.12.0$ brew list zsh --versions |tr " " ""node11.0.010.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 b801cc6b71e7c09448b4f823e493710665de68ebAuthor: 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 -vv11.0.0$ brew switch node 10.12.0Cleaning /usr/local/Cellar/node/10.12.0Cleaning /usr/local/Cellar/node/11.0.07 links created for /usr/local/Cellar/node/10.12.0$ node -vv10.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 的文件链接shell $ 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 DocumentationHomebrew terminology - Homebrew DocumentationFAQ - Homebrew Documentationhomebrew - how to install older versions - Stack OverflowHomebrew install specific version of formula? - Stack OverflowUsing 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 ,且未经许可不能用于商业目的。如有疑问或授权协商请与我联系。