asdf 快速上手指南从零安装到管理 Node.js 等多语言运行时版本【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdfasdf 是一个可扩展的多语言运行时版本管理器通过统一的plugin → tool → version三层模型让 Ruby、Node.js、Elixir、Erlang 等工具在同一个 CLI 下被安装、切换与共享配置。本文基于官方 Getting Started 指南结合仓库源码完整演示从安装依赖、下载核心、配置 Shell到安装插件、安装版本、设置全局与项目版本的全流程读完即可在自己的机器上复现 Node.js 版本管理环境。安装总览asdf 的六步核心流程一次完整的 asdf 部署由六个环节组成这也是后续所有命令的组织骨架安装依赖git与curl下载 asdf 核心安装并配置 asdf按 Shell 与安装方式选择为每个要管理的工具安装插件plugin安装对应工具的具体版本通过.tool-versions配置文件设置全局与项目版本这六步分别对应仓库中internal/下的plugins、versions、toolversions、resolve等模块。理解先插件、后版本、再配置的次序是掌握 asdf 一切操作的前提。1. 安装依赖asdf 核心依赖git与curl。下表给出常见发行版与包管理器的安装命令非穷举部分步骤可能在后续安装中自动完成OSPackage ManagerCommandlinuxAptitudeapt install curl gitlinuxDNFdnf install curl gitlinuxPacmanpacman -S curl gitlinuxZypperzypper install curl gitmacOSHomebrewbrew install coreutils curl gitmacOSSpackspack install coreutils curl git::: tip 提示 根据系统权限配置上述命令可能需要加sudo。 :::注意git不仅用于下载 asdf 本身插件plugin本质上也是 Git 仓库——plugins.go 中的Add正是通过git.NewRepo(...).Clone(...)把插件克隆到数据目录。因此git的可用性是插件体系的基石。2. 下载 asdf官方方式推荐官方强烈推荐使用git方式下载核心并固定到稳定版本分支。当前仓库版本号为0.15.0见 version.txt安装时克隆v0.15.0分支即可git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.15.0该目录在后续配置中被称为ASDF_DIR默认$HOME/.asdf既是核心脚本所在地也是插件、下载物、安装版本与 shims 的默认存放位置见 data.go 中downloads、installs、plugins三个子目录的划分。社区支持的其他方式方式命令Homebrewbrew install asdfPacmangit clone https://aur.archlinux.org/asdf-vm.git cd asdf-vm makepkg -si或使用你偏好的 AUR 助手使用 Homebrew / AUR 安装时后续 Shell 配置中的路径需要相应替换为$(brew --prefix asdf)/libexec/...或/opt/asdf-vm/...。3. 安装并配置 asdfShell、操作系统与安装方式的组合众多配置各不相同。请按下表展开与你系统匹配的配置段。macOS 用户务必阅读本节末尾关于path_helper的警告。BashBash Git在~/.bashrc中加入. $HOME/.asdf/asdf.sh补全completions配置. $HOME/.asdf/completions/asdf.bashBash Git (macOS)macOS Catalina 及更新版本默认 Shell 已改为 ZSH除非主动切回 Bash否则请按 ZSH 配置。Bash 下写入~/.bash_profile. $HOME/.asdf/asdf.sh . $HOME/.asdf/completions/asdf.bashBash Homebrewecho -e \n. \$(brew --prefix asdf)/libexec/asdf.sh\ ~/.bashrc echo -e \n. \$(brew --prefix asdf)/etc/bash_completion.d/asdf.bash\ ~/.bashrcBash Pacman~/.bashrc中加入. /opt/asdf-vm/asdf.sh并需要安装bash-completion包以启用补全。FishFish Git在~/.config/fish/config.fish中source ~/.asdf/asdf.fish手动配置补全mkdir -p ~/.config/fish/completions; and ln -s ~/.asdf/completions/asdf.fish ~/.config/fish/completionsFish Homebrewecho -e \nsource (brew --prefix asdf)/libexec/asdf.fish ~/.config/fish/config.fish补全由 Homebrew 自动处理。Fish Pacmansource /opt/asdf-vm/asdf.fish补全由 AUR 包在安装时自动配置。ElvishElvish Gitmkdir -p ~/.config/elvish/lib; ln -s ~/.asdf/asdf.elv ~/.config/elvish/lib/asdf.elv echo \nuse asdf _asdf; var asdf~ $_asdf:asdf~ ~/.config/elvish/rc.elv echo \nset edit:completion:arg-completer[asdf] $_asdf:arg-completer~ ~/.config/elvish/rc.elv补全自动配置。Homebrew 与 Pacman 方式分别把链接路径换成(brew --prefix asdf)/libexec/asdf.elv或/opt/asdf-vm/asdf.elv即可。ZSHZSH Git在~/.zshrc中加入. $HOME/.asdf/asdf.sh或使用 oh-my-zsh 的asdf插件它会自动 source 该脚本并配置补全。手动配置补全# append completions to fpath fpath(${ASDF_DIR}/completions $fpath) # initialise completions with ZSHs compinit autoload -Uz compinit compinit两点注意若使用自定义compinit配置确保compinit位于asdf.sh的 source 之后若使用带框架的自定义compinit则compinit需位于框架 source 之后。ZSH Homebrewecho -e \n. $(brew --prefix asdf)/libexec/asdf.sh ${ZDOTDIR:-~}/.zshrc或使用框架插件补全按 Homebrew 文档配置ZSH 框架的 asdf 插件可能需要更新以通过fpath使用新版补全。ZSH Pacman~/.zshrc中加入. /opt/asdf-vm/asdf.sh并配置 ZSH 自动补全。PowerShell CoreGit在~/.config/powershell/profile.ps1中. $HOME/.asdf/asdf.ps1Homebrew. $(brew --prefix asdf)/libexec/asdf.ps1。Pacman. /opt/asdf-vm/asdf.ps1。NushellGit在~/.config/nushell/config.nu中\n$env.ASDF_DIR ($env.HOME | path join .asdf)\n source ($env.HOME | path join .asdf/asdf.nu) | save --append $nu.config-pathHomebrew与Pacman分别将ASDF_DIR指向(brew --prefix asdf | str trim | into string | path join libexec)与/opt/asdf-vm/。补全均自动配置。POSIX ShellGit在~/.profile中export ASDF_DIR$HOME/.asdf . $HOME/.asdf/asdf.shHomebrewecho -e \nexport ASDF_DIR\$(brew --prefix asdf)/libexec/asdf.sh\ ~/.profile echo -e \n. \$(brew --prefix asdf)/libexec/asdf.sh\ ~/.profilePacmanexport ASDF_DIR/opt/asdf-vm . /opt/asdf-vm/asdf.sh统一注意事项asdf脚本必须在设置完$PATH、并 source 完框架如 oh-my-zsh之后再被 source。::: warning macOS 警告 在 macOS 上启动 Bash 或 Zsh 时系统会自动调用path_helper它可能重排PATH及MANPATH中的条目破坏对顺序敏感的工具。为规避此问题asdf 在 macOS 上默认将自身PATH条目强制置于最前最高优先级该行为可通过环境变量ASDF_FORCE_PREPEND控制。 :::配置完成后重启 Shell新开终端标签页即可使PATH生效。核心安装完成到此 asdf 核心已安装完毕。但正如 help.txt 所展示的命令体系asdf 只有在安装插件、安装工具并管理其版本之后才有实际价值。4. 安装插件以 Node.js 为例下文以 Node.js 为例演示插件安装与使用对应asdf-nodejs插件。插件依赖每个插件可能依赖额外的系统软件需查看插件仓库的依赖说明。asdf-nodejs的依赖如下OS依赖安装命令Debianapt-get install dirmngr gpg curl gawkCentOS / Rocky Linux / AlmaLinuxyum install gnupg2 curl gawkmacOSbrew install gpg gawk应在安装插件前先装好这些依赖因为部分插件带有 post-install 钩子如post-plugin-add回调见 plugins.go。安装插件asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git从源码看asdf plugin add的底层逻辑plugins.go会先校验插件名仅允许小写字母、数字、_与-检查是否已存在然后克隆插件仓库到$ASDF_DATA_DIR/plugins/nodejs并执行pre/post_asdf_plugin_add钩子。如果省略 Git URLasdf 会从短名插件仓库asdf-plugins解析默认地址若配置了disable_plugin_short_name_repository yes则必须显式给出 URL。5. 安装工具版本拥有 Node.js 插件后即可安装具体版本。查看可用版本asdf list all nodejs # 列出全部版本 asdf list all nodejs 14 # 只列出以 14 开头的版本子集安装最新稳定版asdf install nodejs latest::: tip 提示 asdf 只认精确版本latest是贯穿 asdf 各子命令的辅助关键字会在执行时被解析为当时的实际版本号。 :::从实现看versions.golatest的解析优先调用插件的latest-stable回调若插件未提供该回调则回退调用list-all通过正则过滤掉-src、-dev、-rc、-alpha、-beta、snapshot等候选版本默认选取以数字开头的最后一个版本latest:version形式则匹配以指定字符串开头的版本。安装过程中 asdf 还会依次执行 pre-download / download / pre-install / install 回调、重新生成 shimsshims.GenerateAll并在成功后默认删除下载目录受always_keep_download配置控制失败时自动清理安装目录versions.go。6. 设置版本asdf 执行某个被管理的工具时会**即时just-in-time**在从当前工作目录向上直到$HOME的路径上查找所有.tool-versions文件并解析版本。这一查找逻辑在 resolve.go 中实现逐级向上搜索父目录直到根目录后回退到用户主目录解析优先级为「环境变量 → 就近的.tool-versions→ 主目录.tool-versions」。::: warning 警告 若某个工具没有被列出版本执行该工具将报错。可用asdf current查看当前目录下各工具的版本解析结果或缺失情况从而判断哪些工具会执行失败。 :::全局版本全局默认版本记录在$HOME/.tool-versionsasdf global nodejs latest此时$HOME/.tool-versions内容为nodejs 16.5.0部分操作系统已自带由系统而非 asdf管理的工具python是常见例子此时需要让 asdf 把管理权交还系统将版本设置为system关键字即可透传详见 Versions 参考文档。本地项目版本本地版本定义在$PWD/.tool-versions即当前工作目录通常是项目的 Git 仓库根目录。在目标目录下执行asdf local nodejs latest此时$PWD/.tool-versions内容为nodejs 16.5.0复用其他版本管理器的旧版本文件asdf 支持从其他版本管理器已有的版本文件迁移例如 rbenv 的.ruby-version该能力按插件逐个提供。asdf-nodejs同时支持.nvmrc与.node-version文件。启用方式是在 asdf 配置$HOME/.asdfrc中加入legacy_version_file yes其解析过程可在 resolve.go 中看到启用后asdf 会调用插件的list-legacy-filenames回调获取旧文件名列表逐目录查找并用parse-legacy-file回调若存在解析版本。配置项的默认值与解析逻辑参见 config.go 与仓库默认配置 defaults。.tool-versions文件本身也支持注释与多版本例如python 3.7.2 2.7.15 system会按顺序回退尝试更多格式细节ref:、path:、system等版本类型见 toolversions.go 的解析实现请查阅 Configuration 参考文档。指南完成与下一步至此你已经能用 asdf 管理 Node.js 的项目版本。对其余工具重复同样的流程插件 → 安装版本 → 设置版本即可。asdf 还有更多命令可探索运行asdf --help或直接输入asdf即可查看全部命令核心命令分为三大类核心 asdf 命令插件管理工具版本管理其中 versions.md 还介绍了 shims 机制安装工具时 asdf 会在$ASDF_DATA_DIR/shims中为每个可执行文件生成包装脚本见 shims.go其本质是exec asdf exec command $并通过asdf exec完成版本解析与实际可执行文件的定位。理解 shims 的 exec 语义有助于处理需要被 Shell source 的脚本场景应使用asdf which/asdf where直接获取安装路径。【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
asdf 快速上手指南：从零安装到管理 Node.js 等多语言运行时版本
asdf 快速上手指南从零安装到管理 Node.js 等多语言运行时版本【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdfasdf 是一个可扩展的多语言运行时版本管理器通过统一的plugin → tool → version三层模型让 Ruby、Node.js、Elixir、Erlang 等工具在同一个 CLI 下被安装、切换与共享配置。本文基于官方 Getting Started 指南结合仓库源码完整演示从安装依赖、下载核心、配置 Shell到安装插件、安装版本、设置全局与项目版本的全流程读完即可在自己的机器上复现 Node.js 版本管理环境。安装总览asdf 的六步核心流程一次完整的 asdf 部署由六个环节组成这也是后续所有命令的组织骨架安装依赖git与curl下载 asdf 核心安装并配置 asdf按 Shell 与安装方式选择为每个要管理的工具安装插件plugin安装对应工具的具体版本通过.tool-versions配置文件设置全局与项目版本这六步分别对应仓库中internal/下的plugins、versions、toolversions、resolve等模块。理解先插件、后版本、再配置的次序是掌握 asdf 一切操作的前提。1. 安装依赖asdf 核心依赖git与curl。下表给出常见发行版与包管理器的安装命令非穷举部分步骤可能在后续安装中自动完成OSPackage ManagerCommandlinuxAptitudeapt install curl gitlinuxDNFdnf install curl gitlinuxPacmanpacman -S curl gitlinuxZypperzypper install curl gitmacOSHomebrewbrew install coreutils curl gitmacOSSpackspack install coreutils curl git::: tip 提示 根据系统权限配置上述命令可能需要加sudo。 :::注意git不仅用于下载 asdf 本身插件plugin本质上也是 Git 仓库——plugins.go 中的Add正是通过git.NewRepo(...).Clone(...)把插件克隆到数据目录。因此git的可用性是插件体系的基石。2. 下载 asdf官方方式推荐官方强烈推荐使用git方式下载核心并固定到稳定版本分支。当前仓库版本号为0.15.0见 version.txt安装时克隆v0.15.0分支即可git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.15.0该目录在后续配置中被称为ASDF_DIR默认$HOME/.asdf既是核心脚本所在地也是插件、下载物、安装版本与 shims 的默认存放位置见 data.go 中downloads、installs、plugins三个子目录的划分。社区支持的其他方式方式命令Homebrewbrew install asdfPacmangit clone https://aur.archlinux.org/asdf-vm.git cd asdf-vm makepkg -si或使用你偏好的 AUR 助手使用 Homebrew / AUR 安装时后续 Shell 配置中的路径需要相应替换为$(brew --prefix asdf)/libexec/...或/opt/asdf-vm/...。3. 安装并配置 asdfShell、操作系统与安装方式的组合众多配置各不相同。请按下表展开与你系统匹配的配置段。macOS 用户务必阅读本节末尾关于path_helper的警告。BashBash Git在~/.bashrc中加入. $HOME/.asdf/asdf.sh补全completions配置. $HOME/.asdf/completions/asdf.bashBash Git (macOS)macOS Catalina 及更新版本默认 Shell 已改为 ZSH除非主动切回 Bash否则请按 ZSH 配置。Bash 下写入~/.bash_profile. $HOME/.asdf/asdf.sh . $HOME/.asdf/completions/asdf.bashBash Homebrewecho -e \n. \$(brew --prefix asdf)/libexec/asdf.sh\ ~/.bashrc echo -e \n. \$(brew --prefix asdf)/etc/bash_completion.d/asdf.bash\ ~/.bashrcBash Pacman~/.bashrc中加入. /opt/asdf-vm/asdf.sh并需要安装bash-completion包以启用补全。FishFish Git在~/.config/fish/config.fish中source ~/.asdf/asdf.fish手动配置补全mkdir -p ~/.config/fish/completions; and ln -s ~/.asdf/completions/asdf.fish ~/.config/fish/completionsFish Homebrewecho -e \nsource (brew --prefix asdf)/libexec/asdf.fish ~/.config/fish/config.fish补全由 Homebrew 自动处理。Fish Pacmansource /opt/asdf-vm/asdf.fish补全由 AUR 包在安装时自动配置。ElvishElvish Gitmkdir -p ~/.config/elvish/lib; ln -s ~/.asdf/asdf.elv ~/.config/elvish/lib/asdf.elv echo \nuse asdf _asdf; var asdf~ $_asdf:asdf~ ~/.config/elvish/rc.elv echo \nset edit:completion:arg-completer[asdf] $_asdf:arg-completer~ ~/.config/elvish/rc.elv补全自动配置。Homebrew 与 Pacman 方式分别把链接路径换成(brew --prefix asdf)/libexec/asdf.elv或/opt/asdf-vm/asdf.elv即可。ZSHZSH Git在~/.zshrc中加入. $HOME/.asdf/asdf.sh或使用 oh-my-zsh 的asdf插件它会自动 source 该脚本并配置补全。手动配置补全# append completions to fpath fpath(${ASDF_DIR}/completions $fpath) # initialise completions with ZSHs compinit autoload -Uz compinit compinit两点注意若使用自定义compinit配置确保compinit位于asdf.sh的 source 之后若使用带框架的自定义compinit则compinit需位于框架 source 之后。ZSH Homebrewecho -e \n. $(brew --prefix asdf)/libexec/asdf.sh ${ZDOTDIR:-~}/.zshrc或使用框架插件补全按 Homebrew 文档配置ZSH 框架的 asdf 插件可能需要更新以通过fpath使用新版补全。ZSH Pacman~/.zshrc中加入. /opt/asdf-vm/asdf.sh并配置 ZSH 自动补全。PowerShell CoreGit在~/.config/powershell/profile.ps1中. $HOME/.asdf/asdf.ps1Homebrew. $(brew --prefix asdf)/libexec/asdf.ps1。Pacman. /opt/asdf-vm/asdf.ps1。NushellGit在~/.config/nushell/config.nu中\n$env.ASDF_DIR ($env.HOME | path join .asdf)\n source ($env.HOME | path join .asdf/asdf.nu) | save --append $nu.config-pathHomebrew与Pacman分别将ASDF_DIR指向(brew --prefix asdf | str trim | into string | path join libexec)与/opt/asdf-vm/。补全均自动配置。POSIX ShellGit在~/.profile中export ASDF_DIR$HOME/.asdf . $HOME/.asdf/asdf.shHomebrewecho -e \nexport ASDF_DIR\$(brew --prefix asdf)/libexec/asdf.sh\ ~/.profile echo -e \n. \$(brew --prefix asdf)/libexec/asdf.sh\ ~/.profilePacmanexport ASDF_DIR/opt/asdf-vm . /opt/asdf-vm/asdf.sh统一注意事项asdf脚本必须在设置完$PATH、并 source 完框架如 oh-my-zsh之后再被 source。::: warning macOS 警告 在 macOS 上启动 Bash 或 Zsh 时系统会自动调用path_helper它可能重排PATH及MANPATH中的条目破坏对顺序敏感的工具。为规避此问题asdf 在 macOS 上默认将自身PATH条目强制置于最前最高优先级该行为可通过环境变量ASDF_FORCE_PREPEND控制。 :::配置完成后重启 Shell新开终端标签页即可使PATH生效。核心安装完成到此 asdf 核心已安装完毕。但正如 help.txt 所展示的命令体系asdf 只有在安装插件、安装工具并管理其版本之后才有实际价值。4. 安装插件以 Node.js 为例下文以 Node.js 为例演示插件安装与使用对应asdf-nodejs插件。插件依赖每个插件可能依赖额外的系统软件需查看插件仓库的依赖说明。asdf-nodejs的依赖如下OS依赖安装命令Debianapt-get install dirmngr gpg curl gawkCentOS / Rocky Linux / AlmaLinuxyum install gnupg2 curl gawkmacOSbrew install gpg gawk应在安装插件前先装好这些依赖因为部分插件带有 post-install 钩子如post-plugin-add回调见 plugins.go。安装插件asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git从源码看asdf plugin add的底层逻辑plugins.go会先校验插件名仅允许小写字母、数字、_与-检查是否已存在然后克隆插件仓库到$ASDF_DATA_DIR/plugins/nodejs并执行pre/post_asdf_plugin_add钩子。如果省略 Git URLasdf 会从短名插件仓库asdf-plugins解析默认地址若配置了disable_plugin_short_name_repository yes则必须显式给出 URL。5. 安装工具版本拥有 Node.js 插件后即可安装具体版本。查看可用版本asdf list all nodejs # 列出全部版本 asdf list all nodejs 14 # 只列出以 14 开头的版本子集安装最新稳定版asdf install nodejs latest::: tip 提示 asdf 只认精确版本latest是贯穿 asdf 各子命令的辅助关键字会在执行时被解析为当时的实际版本号。 :::从实现看versions.golatest的解析优先调用插件的latest-stable回调若插件未提供该回调则回退调用list-all通过正则过滤掉-src、-dev、-rc、-alpha、-beta、snapshot等候选版本默认选取以数字开头的最后一个版本latest:version形式则匹配以指定字符串开头的版本。安装过程中 asdf 还会依次执行 pre-download / download / pre-install / install 回调、重新生成 shimsshims.GenerateAll并在成功后默认删除下载目录受always_keep_download配置控制失败时自动清理安装目录versions.go。6. 设置版本asdf 执行某个被管理的工具时会**即时just-in-time**在从当前工作目录向上直到$HOME的路径上查找所有.tool-versions文件并解析版本。这一查找逻辑在 resolve.go 中实现逐级向上搜索父目录直到根目录后回退到用户主目录解析优先级为「环境变量 → 就近的.tool-versions→ 主目录.tool-versions」。::: warning 警告 若某个工具没有被列出版本执行该工具将报错。可用asdf current查看当前目录下各工具的版本解析结果或缺失情况从而判断哪些工具会执行失败。 :::全局版本全局默认版本记录在$HOME/.tool-versionsasdf global nodejs latest此时$HOME/.tool-versions内容为nodejs 16.5.0部分操作系统已自带由系统而非 asdf管理的工具python是常见例子此时需要让 asdf 把管理权交还系统将版本设置为system关键字即可透传详见 Versions 参考文档。本地项目版本本地版本定义在$PWD/.tool-versions即当前工作目录通常是项目的 Git 仓库根目录。在目标目录下执行asdf local nodejs latest此时$PWD/.tool-versions内容为nodejs 16.5.0复用其他版本管理器的旧版本文件asdf 支持从其他版本管理器已有的版本文件迁移例如 rbenv 的.ruby-version该能力按插件逐个提供。asdf-nodejs同时支持.nvmrc与.node-version文件。启用方式是在 asdf 配置$HOME/.asdfrc中加入legacy_version_file yes其解析过程可在 resolve.go 中看到启用后asdf 会调用插件的list-legacy-filenames回调获取旧文件名列表逐目录查找并用parse-legacy-file回调若存在解析版本。配置项的默认值与解析逻辑参见 config.go 与仓库默认配置 defaults。.tool-versions文件本身也支持注释与多版本例如python 3.7.2 2.7.15 system会按顺序回退尝试更多格式细节ref:、path:、system等版本类型见 toolversions.go 的解析实现请查阅 Configuration 参考文档。指南完成与下一步至此你已经能用 asdf 管理 Node.js 的项目版本。对其余工具重复同样的流程插件 → 安装版本 → 设置版本即可。asdf 还有更多命令可探索运行asdf --help或直接输入asdf即可查看全部命令核心命令分为三大类核心 asdf 命令插件管理工具版本管理其中 versions.md 还介绍了 shims 机制安装工具时 asdf 会在$ASDF_DATA_DIR/shims中为每个可执行文件生成包装脚本见 shims.go其本质是exec asdf exec command $并通过asdf exec完成版本解析与实际可执行文件的定位。理解 shims 的 exec 语义有助于处理需要被 Shell source 的脚本场景应使用asdf which/asdf where直接获取安装路径。【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
