VSCode里node命令报“command not found”是因为PATH未生效：Windows需重装Node并勾选“Add to PATH”或手动添加C:\Program Files\nodejs\到系统环境变量，macOS/Linux需在~/.zshrc中配置export PATH，并彻底重启VSCode后用code .启动验证。
VSCode 里 node 命令报 “command not found” 怎么办
不是插件没装对，也不是 VSCode 设置错了——根本原因是系统 PATH 没生效，VSCode 启动时压根没继承到 node 命令路径。
先在系统终端（不是 VSCode 内置终端）里执行：node -v 和 npm -v。如果报错，说明 Node.js 根本没进系统环境变量。
- Windows：重装 Node.js，安装向导中**必须勾选 “Add to PATH”**；若已装过，手动把
C:\Program Files\nodejs\加进“系统环境变量”里的PATH，然后彻底关闭 VSCode（包括后台进程），再双击图标重启 - macOS/Linux：检查
~/.zshrc或~/.bash_profile是否包含类似export PATH="/opt/homebrew/bin:$PATH"（Homebrew 安装路径）或export PATH="$HOME/.nvm/versions/node/v18.18.2/bin:$PATH"（nvm 路径）；改完后不要只source，要关掉所有 VSCode 窗口，再从终端运行code --no-sandbox .
验证是否修好：打开 VSCode，按 Ctrl+` 唤出内置终端，直接敲 node -v —— 有输出才算过关，否则别往下配调试。
launch.json 中 program 字段填错导致调试失败
VSCode 调试器靠 program 字段定位真实可执行 JS 文件，填错就卡在 “Cannot launch program” 或静默退出。
- 单文件临时调试：用
"program": "${file}"（注意不是${fileBasename}），确保当前打开的是 .js 文件，且光标在编辑器内 - 项目级调试：用
"program": "${workspaceFolder}/app.js"，并确认该路径下真实存在app.js；如果入口是src/index.js，就得写成"program": "${workspaceFolder}/src/index.js" - ESM 项目（
package.json里有"type": "module"）：不能直接跑源码，得加实验性参数："runtimeArgs": ["--experimental-specifier-resolution=node"]
别动 "type": "node" 和 "request": "launch"，这两个是调试器识别协议的关键，改错会导致整个配置被忽略。
code-runner 插件跑 JS 出乱码、假死或不支持 import
code-runner 默认命令太简陋：node $fileName 不处理编码、模块类型、输入流，尤其在 Windows 中文路径或 ESM 下必崩。
- Windows 中文路径乱码：在设置里搜
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 调试模式（它能接管 stdin）
这插件本质是快捷执行器，不是调试器——别指望它做断点、变量监视、调用栈这些事。
调试断点不命中，提示 “Cannot launch program because corresponding JavaScript cannot be found”
这不是代码写错了，而是调试器找不到可执行的 JS 文件，或者 source map 错位。常见于 TypeScript 编译、Webpack 打包、或 ESM/CJS 混用场景。
- TS 项目：确保
tsconfig.json开启"sourceMap": true，且outDir指向生成目录（如dist），launch.json的program必须指向dist/index.js，不是src/index.ts - 打包项目（如 Webpack/Vite）：调试目标必须是实际运行的 bundle 文件（比如
dist/main.js），且 bundle 需带有效 source map；devtool: 'source-map'是底线 - ESM + CommonJS 混用：Node.js 对
import和require的解析规则不同，launch.json里加"env": {"NODE_OPTIONS": "--enable-source-maps"}可缓解部分映射问题
最易被忽略的一点：VSCode 调试器不会自动读取 .env 或 process.env 注入的变量，需要显式在 launch.json 的 env 字段里声明。
