WSL2 Ubuntu 22.04.1中Node版本不匹配：npm无法识别新版Node

问题根源 #

普通用户通过nvm安装的Node位于用户个人目录，sudo执行命令时会加载root环境，优先使用apt安装的系统级旧版Node，导致版本不一致；npm的版本与当前生效的Node版本绑定，因此会识别旧版。

解决步骤 #

1. 彻底移除系统级旧版Node.js和npm

• 卸载已安装的系统包：

  sudo apt purge nodejs npm
  

• 清理残留依赖和缓存：

  sudo apt autoremove && sudo apt autoclean
  

• 检查并删除残留的可执行文件：

  which node && which npm
  

  如果输出路径（如/usr/bin/node），直接删除对应文件：

  sudo rm -rf /usr/bin/node /usr/bin/npm
  

2. 让sudo环境识别nvm安装的新版Node

nvm默认只加载普通用户的bash配置，sudo执行时不会读取，需手动配置全局环境：

• 编辑全局bash配置文件：

  sudo nano /etc/bash.bashrc
  

• 在文件末尾添加以下内容（替换/home/你的用户名为实际用户目录）：

  export NVM_DIR="/home/你的用户名/.nvm"
  [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
  

• 保存退出后，重启终端或执行source /etc/bash.bashrc生效。

3. 配置默认Node版本并验证

• 普通用户下设置默认版本：

  nvm alias default 18.12.1
  

• 验证版本一致性：

  node -v          # 应显示18.12.1
  sudo node -v     # 应显示18.12.1
  npm -v           # 应对应新版Node的npm版本
  

4. 后续避坑注意事项

• 避免用apt install nodejs安装系统级Node，全程用nvm管理版本
• 执行npm命令尽量不用sudo，nvm安装的npm已具备用户目录权限
• 若必须用sudo执行npm，确保sudo的PATH已包含nvm的Node路径

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