vscode本身不运行node.js，必须依赖系统已安装且path正确配置的node命令；验证需彻底退出vscode进程后，在系统终端确认which node或where node路径，再于vscode终端执行node -v和npm -v；launch.json中program必须指向真实js入口文件，如"${workspacefolder}/src/index.js"，typescript项目须指向编译后.js文件并开启sourcemaps，esm项目需package.json设"type":"module"。
VSCode 本身不运行 Node.js 脚本，必须依赖系统已安装且能被正确找到的 node 命令；没装 Node.js、PATH 没配对、或 VSCode 启动时没继承 Shell 环境变量，都会导致 node -v 在终端成功但 F5 报 “Can’t find runtime executable” 或右键 “Run Code” 直接失败。
验证 node 和 npm 是否真可用（不是“看起来可用”）
很多人在系统终端里敲 node -v 看到版本号就以为万事大吉，结果 VSCode 内置终端里执行却报错。这不是 VSCode 的问题，是环境变量没真正生效。
- 关掉所有 VSCode 窗口，**彻底退出进程**（macOS 在 Dock 右键选「退出」，Windows 在任务管理器里确认
Code.exe已结束） - 新开一个系统终端（不是 VSCode 里的），运行
which node（macOS/Linux）或where node（Windows），确认路径指向你安装的 Node.js（如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 再打开 VSCode，按
Ctrl + `打开内置终端，立刻执行node -v和npm -v——这次的结果才代表 VSCode 能调用到 - Windows 用户若用 Scoop/Chocolatey 安装，确保
scoop\shims或choco\bin已加入系统 PATH；macOS/Linux 用 nvm 的，检查~/.nvm/nvm.sh是否已写入~/.zshrc并 reload 过
launch.json 中 program 字段怎么填才不踩坑
program 是调试启动的核心字段，填错会导致断点不命中、报错 “Cannot find module” 或直接退出。它必须指向一个真实存在的、可被 node 直接执行的 JS 文件。
- 单文件调试（如
index.js在项目根目录）：用"program": "${file}"最安全，F5 时自动运行当前打开的文件 - 固定入口文件（如
src/index.js）：显式写成"program": "${workspaceFolder}/src/index.js"，别手输相对路径或漏掉${workspaceFolder} - TypeScript 或 Vite/Webpack 项目：
program必须指向编译后的 JS 文件（如dist/index.js），不是.ts或.jsx源码 - ESM 项目：除了
package.json里加"type": "module"，program指向的文件也得是合法 ESM 格式（比如用了import就不能留require）
别乱碰 runtimeExecutable，95% 的场景根本不需要
runtimeExecutable 是给特殊需求准备的，比如用 nvm 切换版本后要锁定某一个 Node 可执行路径。普通用户加了反而容易出错。
- 绝大多数本地脚本调试，只靠
program就够了，VSCode 会自动调用 PATH 里的node - 只有当你明确需要指定某个特定路径（例如
"runtimeExecutable": "~/.nvm/versions/node/v18.18.2/bin/node"）时才设它 - 如果设了
runtimeExecutable但路径不存在，F5 会直接报 “Can’t find runtime executable”，比不设还难排查 - 用 Code Runner 插件运行脚本时，它默认不走
launch.json，而是自己拼命令；ESM 或中文路径下极易失败，建议关闭该插件，改用 F5 或集成终端手动跑
中文乱码、process.stdin 卡住、调试控制台没输出
这些不是编码设置问题，而是调试器输出流和终端行为不一致导致的。关键在 launch.json 的 console 和 env 配置。
- 中文变问号：加
"console": "integratedTerminal"，让日志输出到 VSCode 底部终端（UTF-8 支持更好），而不是 Debug Console -
process.stdin假死：Code Runner 不支持交互式输入；要么用F5调试（它支持 stdin），要么在集成终端里手动执行node index.js - 调试控制台没日志：加
"env": { "NODE_OPTIONS": "--no-warnings" }，避免某些 warning 干扰 stdout 缓冲 - Windows Git Bash / WSL 下调试异常：不要用 Windows 控制台子系统，默认走集成终端即可，不用额外配
runtimeExecutable
最常被忽略的一点是：VSCode 启动方式直接影响 PATH 继承。从桌面图标或开始菜单启动，大概率读不到 shell 配置的 PATH；macOS/Linux 用户务必用终端执行 code . 打开项目，Windows 用户确保安装 Node.js 时勾选了 “Add to PATH”。环境变量这一步没走稳，后面所有调试配置都是空中楼阁。
