基于 asdf 管理多种运行时

Posted on Edited on In

介绍

asdf 是一个版本管理器，用于在不同的项目中管理和切换软件版本。它支持多种编程语言、工具和框架，包括但不限于：

  • Python
  • Ruby
  • Node.js
  • Java
  • Rust
  • Docker

asdf 的主要优点包括：

  • 版本管理： 允许您轻松安装、切换和卸载不同版本的软件。
  • 项目隔离： 每个项目都可以使用自己的软件版本集，而不会影响其他项目。
  • 跨平台支持： 可在 macOS、Linux 和 Windows 上使用。
  • 易于使用： 具有简洁直观的命令行界面。

安装

1
2
brew install asdf
echo -e "\n. $(brew --prefix asdf)/libexec/asdf.sh" >> ${ZDOTDIR:-~}/.zshrc

也可以使用 asdf for oh-my-zsh 来自动加载

使用

插件相关

1
2
3
4
5
6
7
8
9
10
11
12
# 安装插件，比如 nodejs
asdf plugin-add <plugin>
# 列出已安装的插件
asdf plugin-list
# 列出所有支持的插件
asdf plugin-list-all
# 卸载插件
asdf plugin-remove <plugin>
# 更新插件
asdf plugin-update <plugin>
# 更新所有插件
asdf plugin-update --all

运行时相关

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 列出已安装的运行时
asdf list

# 安装插件
asdf install <plugin> <version>

# 设置运行时默认版本
asdf global <plugin> <version>

# 切换版本
asdf local <plugin> <version>

# 卸载运行时插件
asdf uninstall <plugin> <version>

其他有用的命令

  • asdf rehash：重新加载所有插件
  • asdf which：显示特定插件的路径
  • asdf doctor：诊断 asdf 安装问题

zsh 特有命令

  • asdf-reshim：重新加载 asdf 插件，并在当前 shell 中设置环境变量
  • asdf-where：显示特定插件的安装路径

示例：使用 asdf 管理 Python 版本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 安装 Python 3.10.0
asdf install python 3.10.0

# 设置 Python 3.10.0 为默认版本
asdf global python 3.10.0

# 切换到 Python 3.9.0
asdf shell python 3.9.0

# 重新加载 asdf 插件并设置环境变量
asdf reshim

# 使用 Python 3.9.0
python --version
# Python 3.9.0

# 切换回默认版本（Python 3.10.0）
asdf shell python default

# 卸载 Python 3.9.0
asdf uninstall python 3.9.0

direnv 配置

1
2
3
4
# 安装 direnv
asdf plugin-add direnv
asdf install direnv latest
asdf global direnv latest

.envrc 配置，用于自动切换运行时

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# .envrc
# check if python version is set in current dir
if [ -f ".tool-versions" ] ; then
    if [ ! -d ".venv" ] ; then
        echo "Installing virtualenv for $(python -V)"
        # if we didn't install `py2venv` for python 2.x, we would need to use
        # `virtualenv`, which you would have to install separately.
        python -m venv .venv
    fi
    echo "Activating $(python -V) virtualenv"
    source .venv/bin/activate
fi
# announce python version and show the path of the current python in ${PATH}
echo "Virtualenv has been activated for $(python -V)"
echo "$(which python)"

结论

asdf 是一个强大的版本管理器，可以帮助您轻松管理和切换不同项目的软件版本。它易于使用，并且受到开发人员社区的广泛支持。

---EOF---