为什么Windows上WSL2 Ubuntu 20.04运行node -v命令不生效？

WSL2运行的Ubuntu 20.04属于独立的Linux环境，默认与Windows宿主的环境变量相互隔离。你在Windows系统下安装的Node.js为Win32可执行程序，未配置到WSL Ubuntu的PATH环境变量时，无法被系统直接识别。

提供两种可选择的解决路径： #

方案1：复用Windows系统已安装的Node.js #

适合临时使用、不需要额外重复安装Node的场景

• 首先确认Windows下Node.js的安装路径，默认安装路径为C:\Program Files\nodejs\，如果自定义过安装路径请替换为对应路径
• 打开WSL Ubuntu终端，编辑用户配置文件：
  如果你使用默认的bash shell，执行nano ~/.bashrc
  如果你使用zsh shell，执行nano ~/.zshrc
• 在配置文件末尾添加以下内容，将Windows Node路径加入WSL的环境变量：

  export PATH=$PATH:/mnt/c/Program Files/nodejs/
  # 如需使用全局安装的npm包，还需添加npm全局路径
  export PATH=$PATH:/mnt/c/Users/你的Windows用户名/AppData/Roaming/npm
  

  注意将上面配置中的你的Windows用户名替换为你实际的Windows系统用户名
• 保存退出编辑器后，执行source ~/.bashrc（zsh用户执行source ~/.zshrc）让配置立即生效
• 执行node -v验证是否可以正常输出版本号
• 如果配置后仍不生效，可检查WSL的跨系统调用配置：
  编辑/etc/wsl.conf文件，确认存在以下配置：

  [interop]
  enabled = true
  appendWindowsPath = true
  

  修改完成后关闭所有WSL终端，在Windows PowerShell中执行wsl --shutdown重启WSL后再次验证即可

方案2：在WSL Ubuntu内单独安装Linux版Node.js（更推荐） #

该方案兼容性更好，不会出现Windows版Node运行Linux项目时的路径、权限兼容问题

• 先更新Ubuntu的软件包索引：sudo apt update
• 如需安装默认版本的Node.js，直接执行：sudo apt install -y nodejs npm
• 如需管理多个Node.js版本，可使用nvm工具进行版本管理，安装完成后执行nvm install --lts即可安装最新的长期支持版Node.js，安装完成后自动生效，可直接执行node -v验证

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