asdf-vm/asdf - 快速上手

❤️❤️❤️❤️❤️❤️ 我们已经正式推出微信小程序，在微信中搜索 TrendForge Pro 即可使用小程序，如果使用 Telegram 请搜索 trendforge_tg ❤️❤️❤️❤️❤️❤️

项目介绍快速开始学习路径贡献者 253 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品依赖分析上榜历史

5分钟快速上手asdf版本管理器

asdf是一个可扩展的CLI工具，用于管理多种编程语言版本，如Ruby、Node.js等，支持按项目切换。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Git 任意必需

所需工具

终端或命令行界面

执行安装和配置命令

必需

操作步骤

安装asdf

使用Git克隆asdf仓库到本地，并添加到shell配置中。

克隆asdf到用户主目录的.asdf文件夹，指定稳定版本v0.14.0

git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0

对于Bash用户，将asdf添加到shell配置（如果是Zsh，请用~/.zshrc替换~/.bashrc）

echo '. $HOME/.asdf/asdf.sh' >> ~/.bashrc

预期结果：：克隆完成后，终端显示'Cloning into...'等消息，无错误。

如果使用其他shell如Zsh或Fish，请参考asdf文档调整命令。

重新加载shell配置

使asdf命令在终端中生效。

重新加载Bash配置（如果是Zsh，请用source ~/.zshrc）

source ~/.bashrc

预期结果：：无输出或显示正常提示，asdf命令现在可用。

如果遇到'command not found'，请检查上一步的路径是否正确。

安装一个语言插件和版本

以Node.js为例，安装插件并设置一个版本。

添加Node.js插件

asdf plugin add nodejs

安装最新版本的Node.js

asdf install nodejs latest

设置全局默认版本为最新

asdf global nodejs latest

预期结果：：插件添加成功显示'Plugin nodejs added'，安装过程显示下载和编译消息，最后设置成功。

可以替换'nodejs'为其他语言如'ruby'或'python'，'latest'可指定具体版本如'20.0.0'。

验证安装

检查asdf和Node.js是否正常工作。

查看asdf版本

asdf --version

查看Node.js版本

node --version

预期结果：：asdf版本显示如'v0.14.0'，Node.js版本显示如'v20.0.0'，确认安装成功。

如果版本不匹配，请检查全局或本地设置。

验证成功

asdf已安装并配置好Node.js，可以管理版本。

asdf --version命令返回版本号

node --version命令返回安装的Node.js版本

快速提示

命令

使用'asdf list all nodejs'查看所有可用Node.js版本

配置

在项目目录创建.tool-versions文件指定版本，如'nodejs 20.0.0'

扩展

更多语言插件见'asdf plugin list all'

常见问题

asdf命令未找到

确保已执行source命令重新加载shell配置，或检查~/.asdf路径是否正确。

安装插件失败

检查网络连接，或尝试指定插件仓库URL，如'asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git'。

版本切换不生效

确认.tool-versions文件在正确目录，或使用'asdf local nodejs 版本号'设置项目本地版本。

下一步

探索更多插件

安装其他语言插件如Ruby或Python，扩展asdf功能。

阅读官方文档

访问asdf-vm.com获取详细命令和高级用法。

贡献或报告问题

在GitHub Issues提交反馈，帮助改进项目。