如何在不存储于当前目录的情况下管理.tool-versions文件

核心思路 #

通过direnv检测当前工作目录，自动匹配存储在~/.asdf/projects/下的自定义版本文件，结合asdf的环境变量机制实现版本自动切换，无需在项目目录提交.tool-versions。

具体实现步骤 #

1. 统一自定义版本文件命名规则

   • 将项目绝对路径中的斜杠/替换为下划线_，生成唯一的版本文件名。例如/home/me/projects/clientname/projectname对应文件名为home_me_projects_clientname_projectname.tool-versions，将该文件放入~/.asdf/projects/目录（目录不存在则执行mkdir -p ~/.asdf/projects创建）。

2. 配置direnv全局自动加载逻辑

   • 编辑~/.direnvrc文件，添加以下脚本（根据你使用的shell调整hook命令）：

     load_asdf_project_version() {
       # 将当前目录路径转为下划线命名的文件名
       local project_path=$(pwd | tr '/' '_')
       local custom_version_file="$HOME/.asdf/projects/${project_path}.tool-versions"
       
       # 存在自定义版本文件时，指定asdf加载它
       if [ -f "$custom_version_file" ]; then
         export ASDF_TOOL_VERSIONS="$custom_version_file"
       else
         # 无自定义文件时恢复默认行为
         unset ASDF_TOOL_VERSIONS
       fi
     }
     
     # 绑定shell钩子，进入目录时自动执行
     eval "$(direnv hook bash)" # zsh用户替换为`direnv hook zsh`
     load_asdf_project_version
     

   • 在目标项目目录执行direnv allow，让direnv生效。

3. 验证效果

   • 进入项目目录后执行asdf current，可确认加载的是自定义版本文件中的配置；切换到其他目录时，asdf自动恢复使用默认的.tool-versions或全局配置。

额外注意事项 #

• 对于强制要求使用nvm的项目，可在自定义.tool-versions中指定对应node版本，asdf的node插件与nvm版本兼容，无需直接使用nvm即可满足项目要求。
• 若不想全局生效，可仅在目标项目目录创建.envrc文件，将上述脚本写入其中并执行direnv allow。

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