VS Code Remote WSL调试Node.js时无法找到node二进制文件问题求助

问题根因 #

VS Code的WSL远程会话启动时，默认调用非登录、非交互模式的shell，这类shell不会加载/etc/profile、~/.bashrc等常规环境配置文件，因此nvm注入的Node.js路径不会被识别，这也是你之前添加的profile.d脚本不生效的原因。

解决方案（按优先级排序） #

1. 全局软链Node.js可执行文件（最省心，一次配置永久生效）

在WSL终端执行以下命令，把当前nvm激活的Node.js版本软链到系统全局PATH路径下：

sudo ln -s $(which node) /usr/local/bin/node
sudo ln -s $(which npm) /usr/local/bin/npm
sudo ln -s $(which npx) /usr/local/bin/npx

/usr/local/bin默认属于所有shell模式的默认PATH，配置后不需要修改任何VS Code设置或项目launch.json，TypeScript调试的preLaunchTask也能正常识别Node.js环境。如果后续切换nvm默认版本，重新执行一次上述软链命令即可。

2. 全局配置VS Code Node.js运行时

打开VS Code设置（快捷键Ctrl+,），搜索Node: Runtime Executable，直接填入你的nvm Node.js路径：
/home/user01/.nvm/versions/node/v14.18.0/bin/node
该配置全局生效，所有项目的调试配置不需要单独指定runtimeExecutable，不会影响TypeScript的前置编译任务。

3. 项目级适配方案

如果不想修改全局配置，可在项目launch.json中添加runtimeVersion字段指定nvm版本，调试器会自动从nvm路径查找对应版本：

{
    "type": "pwa-node",
    "request": "launch",
    "name": "Launch Program",
    "skipFiles": [
        "<node_internals>/**"
    ],
    "program": "${workspaceFolder}/helloworld.js",
    "runtimeVersion": "14.18.0"
}

该方案不需要写死完整路径，切换版本时只需要修改版本号即可，也不会和TypeScript的preLaunchTask冲突。

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