Remote-SSH连上后node -v报command not found，根本原因是VS Code默认以非登录shell启动，未加载~/.bashrc或~/.zshrc导致PATH缺失；需向~/.profile添加exec bash -l、向~/.bashrc添加export PATH="$HOME/local/bin:$PATH"并重连。
Remote-SSH 连上后 node -v 报 command not found 怎么办
不是插件没装、也不是远程服务器没装 Node.js，是 VS Code 的 Remote-SSH 启动时默认用非登录 shell（/bin/sh），压根不加载你的 ~/.bashrc 或 ~/.zshrc，PATH 里自然没有 node 路径。
- 先在远程终端执行
echo $PATH，确认输出里不含你放 node 的路径（比如~/local/bin） - 执行
which node，如果为空但你知道二进制在~/node-v20.15.0-linux-arm64/bin/node，说明只是环境变量没生效 - 往
~/.profile末尾加一行：exec bash -l（强制每次登录都走 login shell） - 再往
~/.bashrc加：export PATH="$HOME/local/bin:$PATH"，然后source ~/.bashrc - 断开连接，重新 Connect to Host —— 这次打开终端就该有
node -v输出了
远程终端能跑 node，但 F5 调试报 Cannot find runtime 'node'
终端和调试器加载环境是两套逻辑：终端继承 shell 配置，调试器只查系统 PATH 或你硬写的 runtimeExecutable。即使 echo $PATH 看起来对，调试器仍可能找不到。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 在 VS Code 的 Debug Console 里执行
process.execPath，看它实际调用的是哪个 node 路径 - 如果输出是
/usr/bin/node但你想用 nvm 安装的 v20.15.0，就得在.vscode/launch.json里显式写死："runtimeExecutable": "/home/user/.nvm/versions/node/v20.15.0/bin/node" - 路径中不能含中文或空格；Linux/macOS 用正斜杠，Windows 用双反斜杠
\ - 别设
"runtimeExecutable": "npm"—— npm 不是可执行二进制，调试器无法注入断点
远程运行 npm script 点不动或日志空白
VS Code 的「NPM SCRIPTS」面板不读你终端里 npm config 的设置，也不自动加载 shell 配置，所以镜像、registry、prefix 全部失效。
- 在远程终端执行：
npm config set registry https://registry.npmmirror.com（国内必配） - 确认全局安装路径是否合理：
npm config get prefix，如果是/usr/local就容易权限报错，建议改成~/local - 在
launch.json中调试 npm script 时，必须加："console": "integratedTerminal"，否则日志全丢在后台看不到 - 配置示例：
{ "type": "node", "request": "launch", "name": "npm start", "program": "npm", "args": ["start"], "console": "integratedTerminal", "cwd": "${workspaceFolder}" }
远程调试时断点不命中、source map 失效
根本原因是远程机器上的源码路径（/home/user/project/src/index.js）和本地 VS Code 打开的路径（C:Usersmeprojectsrcindex.js）完全不一致，调试器无法映射。
- 确保
launch.json中启用了"sourceMaps": true，且项目编译输出带map文件 - 关键字段必须配准：
"remoteRoot": "/home/user/project"（远程绝对路径）和"localRoot": "${workspaceFolder}"（本地路径） - 如果用 TypeScript，
tsconfig.json里"outDir"和"sourceRoot"要匹配，否则dist/index.js找不到src/下的原始文件 - 避免在远程用
npm link或符号链接——调试器不解析 symlink，路径一错全崩
