根本原因是vscode未加载shell配置文件（如~/.bashrc），导致path缺失；必须在wsl终端执行code .启动vscode以继承环境变量，否则内置终端无法识别node。
VSCode内置终端里 node 命令报 command not found
根本原因不是 Node.js 没装，而是 VSCode 启动时没加载你的 shell 环境变量。比如你在 WSL 里用 nvs 装了 Node，node -v 在 WSL 终端里能跑，但 VSCode 内置终端里却找不到——因为你从 Windows 开始菜单点开 VSCode，它压根没读 ~/.bashrc 或 ~/.zshrc。
必须在 WSL 终端里进项目目录，执行：code . 打开 VSCode。这样它才会继承当前 shell 的 PATH 和所有初始化逻辑。
- 已打开 VSCode？先关掉所有窗口，运行
wsl --shutdown，再进项目目录执行code . - 验证是否生效：在 VSCode 内置终端里运行
which node，输出应是类似/home/xxx/.nvs/default/bin/node，而不是空或 Windows 路径 - 如果仍不行，检查
~/.bashrc末尾有没有. "$NVS_HOME/nvs.sh"这类初始化语句，没有就补上
launch.json 里调试时断点不命中
常见于你右键某个 .js 文件点 “Debug Script”，但项目用了 ESM（import）或 "type": "module"，而默认调试器没启用对应解析规则。
直接改 .vscode/launch.json，别依赖自动配置：
- ESM 项目：加
"runtimeArgs": ["--experimental-specifier-resolution=node"] - CommonJS 项目：确保
"program"指向真实可执行文件，比如"${workspaceFolder}/index.js"，不能是.ts或未编译源码 - 别写
"runtimeExecutable": "nodemon"——VSCode 调试器只认原生node；要用 nodemon，改用tasks.json启动更稳妥
用 code-runner 插件跑脚本总出错
code-runner 默认命令是 node $fileName，它不处理模块类型、编码、输入流，也不读 package.json 配置。中文路径乱码、ESM 报错、process.stdin 假死，全是它的硬伤。
临时绕过只适用于简单脚本：
- 中文路径乱码：在 VSCode 设置里搜
code-runner.executorMap，把javascript对应值改成："node -r utf-8 $fileName" - ESM 报
Cannot use import statement outside a module：说明它无视package.json的"type": "module"，直接换用内置终端执行node index.js
服务启动后浏览器打不开 localhost:3000
不是代码问题，大概率是监听地址写死了 127.0.0.1 或 localhost，导致外部（比如 WSL 子系统外的 Windows 浏览器）连不上。
改监听地址为 0.0.0.0：
- Express 项目：
app.listen(3000, '0.0.0.0') - 原生
http模块：server.listen(3000, '0.0.0.0') - 如果是 Docker 或远程开发，还要确认端口是否映射、防火墙是否放行
真正麻烦的从来不是写几行 node app.js，而是环境链路里哪一环悄悄断开了——比如 WSL 的 PATH、launch.json 的 runtimeArgs、监听地址的绑定范围，这些地方不显眼，但一错就全卡住。
