WSL环境下使用NVM切换Node.js版本失败，求解决建议

1. 检查nvm环境变量配置 #

• 打开当前shell的配置文件（bash用~/.bashrc，zsh用~/.zshrc），确认存在以下配置：

  export NVM_DIR="$HOME/.nvm"
  [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
  

• 如果缺失，手动添加后执行source ~/.bashrc（对应你的配置文件）使配置生效。

2. 验证nvm加载状态 #

• 执行command -v nvm，如果输出nvm说明加载正常；如果无输出，重启WSL终端或者重新source配置文件。

3. 排查全局Node.js冲突 #

• 执行which node，如果输出路径不是$NVM_DIR/versions/node/v<目标版本>/bin/node，说明系统存在全局安装的Node.js（比如通过apt安装）。
• 执行sudo apt remove --purge nodejs npm卸载全局版本，避免和nvm管理的版本冲突。

4. 修复nvm目录权限 #

• 执行ls -ld ~/.nvm，检查目录所有者是否为当前用户。
• 如果权限异常，执行chown -R $USER:$USER ~/.nvm修复权限。

5. WSL专属注意事项 #

• 必须在WSL终端内执行nvm命令，不要在Windows的CMD/PowerShell中操作。
• 避免在Windows挂载的目录（如/mnt/c）下运行Node.js相关命令，这类目录的权限和文件系统特性会导致nvm失效。

切换版本后，立即执行node -v和npm -v验证版本是否切换成功。

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