PROVIDER - 一个工具管理所有运行时版本

asdf

asdf 用 1 个工具统一管理 Node、Python、Ruby 等数百种运行时版本,600+ 插件与 .tool-versions 文件让进入目录即自动切换;但 2024 年后社区活跃度下降、插件行为不一,官方建议迁移到 mise。

开发工具 美国 2026.11.19
4.1分

详细说明

优势 5 项

用 1 个命令行工具统一管理 Node、Python、Ruby、Java 等数百种运行时版本
通过插件机制扩展支持的语言与工具,官方与社区插件超过 600 个
项目根目录的 1 份 .tool-versions 文件锁定版本,进入目录自动切换
单机可并存 3 个以上版本,避免 nvm、pyenv、rbenv 等工具重复安装
0 依赖的纯 Shell 实现,安装后仅需 1 次配置即可长期使用

不足 4 项

2024 年后社区活跃度下降,部分插件更新滞后,官方推荐迁移到 mise
每个插件版本行为不一致,安装二进制依赖时可能受系统环境影响
缺少统一的依赖解析与锁文件,团队一致性依赖 .tool-versions 自觉维护
完成多版本切换后仍需手动确认 PATH 生效顺序

服务商概述

asdf 是一个多语言运行时版本管理器。它通过插件把各种语言的版本管理统一到同一个命令下,项目目录中的 .tool-versions 文件决定当前应使用哪个版本。

在开发工具分类里,它代表「统一版本管理层」:团队不必为每种语言安装一套专用版本管理器,一套 asdf 即可覆盖后端、前端与基础设施工具链。

核心优势

  • 统一入口:1 个命令覆盖数百种运行时
  • 插件生态:官方与社区插件 600 个以上
  • 目录级切换:.tool-versions 让版本随项目自动生效
  • 减少重复:替代 nvm、pyenv、rbenv 等多套工具
  • 零依赖:纯 Shell 实现,安装配置简单

产品生态

平台能力

版本安装与切换、全局与项目级版本设置、插件管理、命令 shim 与版本查询。

集成

可与 direnv、GitHub Actions、Docker、Makefile 以及各语言原生工具链配合。

典型场景

多语言单体仓库、需要固定工具版本的团队协作、CI 中的运行时一致性。

不足之处

  • 维护风险:2024 年后活跃度下降,官方推荐迁移到 mise
  • 插件差异:不同插件版本行为不一致
  • 无锁文件:团队一致性依赖 .tool-versions 自觉维护
  • PATH 顺序:多版本场景仍需确认生效顺序

适用场景

  • 多语言仓库(★★★★☆):一工具覆盖全部运行时
  • 团队工具版本统一(★★★★☆):目录级版本声明易于评审
  • 新项目起步(★★★☆☆):可直接选 mise 等后继方案
  • 需要强锁定与任务编排(★★★☆☆):mise 或专用工具更合适

价格参考

项目 价格 备注
asdf 本体 $0 MIT 开源,可商用
社区插件 $0 由各项目自行维护
商业支持 无 通过社区讨论与 Issue 获得帮助

常见问题

asdf 与 nvm、pyenv 的区别是什么?

nvm 与 pyenv 只管理单一语言,asdf 用插件统一管理多种语言,减少工具数量。

.tool-versions 应该提交到仓库吗?

应该提交,它是团队与 CI 使用相同版本的基础。

可以把 asdf 迁移到 mise 吗?

可以。mise 兼容 .tool-versions 与 asdf 插件,迁移成本较低。

安装失败常见原因是什么?

多为插件版本过旧或缺少系统编译依赖,可通过插件更新与安装构建工具解决。

代码示例

# 安装 asdf(macOS)
brew install asdf

# 添加语言插件并安装版本
asdf plugin add nodejs
asdf install nodejs 20.11.1
asdf global nodejs 20.11.1

# 为当前项目固定版本
asdf local python 3.11.8
cat .tool-versions
# .tool-versions 示例
nodejs 20.11.1
python 3.11.8
ruby 3.3.0

社区与资源

  • 官方网站:https://asdf-vm.com/
  • 源码仓库:https://github.com/asdf-vm/asdf
  • 插件列表:https://github.com/asdf-vm/asdf-plugins
前往 asdf 官网 → https://asdf-vm.com/
访问官网 ↗