已安装asdf插件（elixir/node）但终端无法运行命令的求助

排查及修复步骤 #

• 检查asdf初始化脚本是否加载
  打开你的shell配置文件（如~/.bashrc、~/.zshrc），确认是否添加了以下代码：

  . "$HOME/.asdf/asdf.sh"
  

  若使用bash，还需添加补全脚本：

  . "$HOME/.asdf/completions/asdf.bash"
  

  修改后执行source ~/.bashrc（对应你的配置文件）重新加载。

• 确认版本已正确激活

  • 全局生效：执行asdf global <插件名> <版本号>，例如：

    asdf global elixir 1.14.3-otp-25
    asdf global nodejs 16.17.0
    

  • 局部目录生效：在目标目录执行asdf local <插件名> <版本号>，会生成.tool-versions文件
  • 执行asdf current查看当前生效版本，确保对应插件的版本已被选中

• 检查PATH环境变量
  执行echo $PATH，确认输出中包含$HOME/.asdf/shims路径。若没有，在shell配置文件中添加：

  export PATH="$HOME/.asdf/shims:$PATH"
  

  重新加载配置文件即可。

• 重新生成shims链接
  执行asdf reshim <插件名>强制更新命令链接，例如：

  asdf reshim elixir
  asdf reshim nodejs
  

内容的提问来源于stack exchange，提问作者user15254140