CLI 工具多版本管理器 - asdf

asdf 是一个 CLI 工具，可以根据每个项目管理多个工具或语言运行时版本。它就像 gvm、nvm、rbenv 和 pyenv（以及更多）的合一工具！只需安装您语言的插件即可！

这个随手起的名字，可能是目前地表最强版本管理器。

https://github.com/asdf-vm/asdf

一、安装 asdf

以 macbook 为示例

brew install asdf

asdf -v
asdf version 0.16.2

0.16.0 以上命令有较大变更，详见：https://asdf-vm.com/guide/upgrading-to-v0-16.html#breaking-changes 本文使用 0.16.0 版本的命令。vim ~/.zshrc

# asdf
export PATH="${ASDF_DATA_DIR:-$HOME/.asdf}/shims:$PATH"

二、安装扩展

下面以 Go 语言作为示例。查看支持的语言版本 https://github.com/asdf-vm/asdf-plugins，找到 Go：

asdf plugin add golang

# 也可以加上对应的 git 地址
asdf plugin add golang https://github.com/asdf-community/asdf-golang.git

三、安装命令版本

我们安装 2 个版本

asdf install golang 1.24.0
asdf install golang 1.23.6

并在 ~/.zshrc 增加下行，用来设置 GO 常用的环境变量

source $HOME/.asdf/plugins/golang/set-env.zsh

设置 golang 生效版本

 asdf set golang 1.24.0

输入上述命令后，会在本地生成一个文件，.tool-versions。内容如下：

go 1.24.0

接下来进行验证：

# asdf set golang 1.24.0 
# go version
go version go1.24.0 darwin/arm64
# where go
/Users/brian/.asdf/shims/go
# asdf set golang 1.23.6
# go version
go version go1.23.6 darwin/arm64

其他常用命令

查看当前版本

# asdf current
golang          1.24.0          /Users/brian/.tool-versions

查看已经安装的版本

# asdf list golang
 *1.23.6
  1.24.0

四、前端项目实践

项目需要：nodejs 18.20.6、pnpm 9.11.0

asdf plugin add nodejs
asdf plugin add pnpm
asdf install nodejs 18.20.6
asdf install pnpm 9.11.0

设置：

asdf set nodejs 18.20.6
asdf set npm 10.8.2
asdf set pnpm 9.11.0

验证：

node -v
v18.20.6
npm -v
10.8.2
pnpm -v
9.11.0

查看 .tool-version，并将该文件纳入到版本控制。其他同事只要也正确安装了该版本，在该项目中就会自动切换到该版本。

cat .tool-versions
pnpm 9.11.0
nodejs 18.20.6

如果没有安装对应的版本，执行 pnpm install 会给出对应的提示，非常适用团队协作。

No preset version installed for command pnpmPlease install a version by running one of the following:asdf install pnpm 9.12.0or add one of the following versions in your config file at /opt/case/commerce/baize-frontend/.tool-versionspnpm 9.11.0

结语：如果你也经常头疼于多项目不同工具和语言版本的问题，欢迎一起交流学习。