VSCode启动时未继承WSL的node命令，根本原因是未从WSL终端执行code .启动，导致shell初始化文件（如~/.bashrc）未加载；必须在WSL中运行code .打开项目，才能正确继承PATH和环境变量，否则内置终端无法识别node。
VSCode 启动时没继承 WSL 的 node 命令
你在 WSL 终端里能正常运行 node -v，但在 VSCode 内置终端（Ctrl + `）里却报 command not found: node —— 这不是插件问题，也不是 VSCode 故障，而是 VSCode 启动方式导致它压根没加载 WSL 的 shell 初始化文件（比如 ~/.bashrc 或 ~/.zshrc）。
解决办法只有一条：别从 Windows 开始菜单或桌面快捷方式启动 VSCode；必须在 WSL 终端里执行 code . 打开当前项目。这样 VSCode 才会继承当前 shell 的 PATH 和所有环境变量，包括你用 nvm 或 nvs 安装的 node。
- 如果已打开 VSCode，关掉再重来：先
wsl --shutdown，然后进项目目录，运行code . - 验证是否生效：在 VSCode 内置终端里直接输
which node，输出路径应是/home/xxx/.nvs/default/bin/node或类似 WSL 内路径，而不是空或 Windows 路径 - 若仍失败，检查
~/.bashrc末尾是否包含nvs或nvm的初始化语句（如. "$NVS_HOME/nvs.sh"），没有就补上
调试时断点不命中，提示 “Cannot launch program”
这是 VSCode 调试器找不到可执行入口，和代码语法无关。常见于你直接右键某个 .js 文件点 “Debug Script”，但该文件依赖 package.json 中的 "type": "module" 或使用了 ESM 语法（import），而默认调试器没启用对应 flag。
正确做法是配置 .vscode/launch.json，明确指定运行时参数：
- ESM 项目（含
import）：在configurations中加"runtimeArgs": ["--experimental-specifier-resolution=node"] - CommonJS 项目：确保
"program"字段指向一个真实存在的、能被node直接执行的 JS 文件，例如"${workspaceFolder}/index.js"，不能是.ts或未编译源码 - 如果项目用了
nodemon或其他 wrapper，不要在launch.json里写"runtimeExecutable": "nodemon"—— VSCode 调试器只认原生node，改用任务（tasks.json）启动服务更稳妥
用 code-runner 插件运行 JS 却乱码或卡死
code-runner 默认命令极简：node $fileName，它不处理编码、模块类型、输入流，也不读 package.json 配置。Windows 中文路径下乱码、ESM 报错、process.stdin 假死，全是它的固有限制。
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
临时绕过方法（仅限简单脚本）：
- 中文路径乱码：在 VSCode 设置里搜
code-runner.executorMap，把javascript对应值改成："node -r utf-8 $fileName" - ESM 报
Cannot use import statement outside a module：确保项目根目录有package.json且含"type": "module"，再把 executor 改成："node --experimental-specifier-resolution=node $fileName" - 遇到
process.stdin就假死：立刻停用code-runner，换用内置终端手动运行，或直接按 F5 用调试模式（它支持交互式输入）
Node.js 安装在 WSL 里，但项目文件放在 Windows 盘（如 /mnt/c/project）
这是性能雷区。WSL2 访问 /mnt/c/ 下的文件，实际走的是跨系统文件桥接层，npm install 会慢 3–5 倍，node_modules 权限也常出问题（尤其带 native addon 的包）。
真正可行的做法只有两个：
- 把项目挪到 WSL 原生路径下，比如
~/projects/my-app；之后所有操作（npm install、pnpm dev）都在 WSL 终端或 VSCode WSL 环境中完成 - 如果非得在 Windows 盘开发（比如和同事共享路径），至少把
node_modules和构建产物（dist、.next）排除在 Windows 盘外：在package.json的scripts里加"postinstall": "rm -rf node_modules && ln -s /home/xxx/projects/my-app/node_modules node_modules"（不推荐，维护成本高） - 千万别在
/mnt/c/下用nvm或nvs切换 Node 版本——它们的 symlink 机制在跨文件系统时容易失效
最常被忽略的一点：VSCode 的 Remote-WSL 插件不是“自动生效”的。即使你装了它，只要没通过 code . 从 WSL 启动，或者没在左下角状态栏点击 “WSL: Ubuntu” 切换连接目标，VSCode 就始终在 Windows 环境里跑，所有配置都白搭。
