根本原因是Node.js未正确安装或VSCode未继承环境变量；必须实测node -v在系统终端和VSCode内置终端均成功，再确认launch.json中program指向真实JS文件且ESM项目已设"type":"module"。

node 命令在 VSCode 里跑不起来，不是插件没装对，也不是 launch.json 写错了——根本原因是系统没装 node，或者 VSCode 根本找不到它。所有“运行”“调试”行为都依赖外部 node，编辑器本身不带运行时。

验证 node 是否真可用

别信安装界面勾了“Add to PATH”就万事大吉，必须实测：

• 关掉所有 VSCode 窗口，包括 Dock/任务栏残留进程
• 打开系统终端（不是 VSCode 内置终端），执行 node -v 和 npm -v；失败就重装 Node.js LTS 版，Windows 安装时务必勾选 Add to PATH
• 再打开 VSCode，按 Ctrl + ` 调出内置终端，立刻执行 node -v；没输出？说明 VSCode 没继承环境变量，别往下配了
• macOS/Linux 用户用 nvm 的，确认 source ~/.zshrc 已写入且新终端已加载；更稳妥的是在终端里执行 code . 启动项目

launch.json 里 program 指向什么才有效

VSCode 调试器只认真实存在的、能被 node 直接执行的 JS 文件，不是源码路径，也不是打包前的文件：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

• 单文件调试：用 "program": "${file}"，但确保当前打开的就是可执行脚本（比如 index.js）
• 入口明确的项目：写死路径，如 "program": "${workspaceFolder}/src/index.js"，别用相对路径 "./src/index.js"（VSCode 不解析 .）
• TypeScript 项目：program 必须指向编译后的 .js 文件（如 dist/index.js），且 tsconfig.json 中开启 "sourceMaps": true
• ESM 项目：package.json 必须有 "type": "module"，否则调试器按 CommonJS 解析，import 报错、路径错乱

别让 code-runner 插件误导你

它默认命令是 node $fileName，极简但极不可靠，尤其在中文路径、ESM、交互式输入场景下会直接失效：

• Windows 中文乱码：在 VSCode 设置中搜 code-runner.executorMap，把 javascript 对应值改成："node -r utf-8 $fileName"
• ESM 报 Cannot use import statement outside a module：先加 "type": "module" 到 package.json，再改 executor 为："node --experimental-specifier-resolution=node $fileName"
• 含 process.stdin 的脚本（如 LeetCode 模拟输入）必然假死——code-runner 不支持 stdin 流，必须进终端手动运行或走 F5 调试
• 它不读 package.json、不处理 source map、不转发环境变量，纯属“一键执行快感”，不适合真实开发流程

断点不命中？先看控制台第一行错误

常见报错 Cannot launch program because corresponding JavaScript cannot be found 或 Can't find runtime executable，和代码逻辑无关，全是配置链断裂：

• 错误类型是 Cannot find module 'xxx'：说明 node 找不到依赖，检查 node_modules 是否存在、npm install 是否成功
• 断点灰色不可用：大概率 program 指向了 .ts 或 .jsx 源文件，或编译后 .js 和 .js.map 不在同一目录
• 调试启动后秒退：launch.json 里误加了 runtimeExecutable 字段，除非你明确要用 nvm 锁定版本（如 "runtimeExecutable": "~/.nvm/versions/node/v18.18.2/bin/node"），否则删掉
• 用了 nodemon？VSCode 调试器不支持热重载，要 attach：命令行先跑 nodemon --inspect-brk index.js，再在 launch.json 配 "type": "node", "request": "attach", "port": 9229

真正卡住人的从来不是 launch.json 语法，而是 node 命令能不能在 VSCode 终端里敲出来、program 路径是不是指向一个实际存在的 JS 文件、以及 ESM 项目有没有那行 "type": "module"。这三件事没确认清楚，其他配置都是空中楼阁。