先说说最让人头疼的那个报错——按 F5 准备调试，结果弹出一句“Can’t find Node.js binary ‘node’”。你终端里明明 node -v 跑得好好的，怎么 VSCode 就不认了？
报错“Can’t find Node.js binary ‘node’”本质是VSCode调试器未继承shell环境PATH，需通过验证where node/which node、确保PATH包含node路径，或在launch.json中显式配置runtimeExecutable指向绝对路径。
VSCode 本身并没有“Node.js 默认运行器”这个选项，你真正需要做的，是确保 node 命令在终端和调试器中都能被正确识别并调用——这取决于系统 PATH 和 launch.json 的配置方式，而不是靠某个开关“设为默认”就能解决。
为什么按 F5 后会提示 “Can’t find Node.js binary ‘node’”
这是最常遇到的报错，其根本原因是 VSCode 启动调试时找不到 node 可执行文件。它不会自动读取你终端里能用的 node 路径，而是依赖自己的环境变量或显式指定的路径。
- 即使你在 CMD 或 PowerShell 里输入
node -v能成功，VSCode 的调试进程可能仍然看不到它——因为 VSCode 启动时没有继承你的 shell 环境变量（尤其在 Windows 下通过快捷方式启动时） - 检查方法：打开 VSCode 内置终端（
Ctrl+`），直接输入where node（Windows）或which node（macOS/Linux），确认输出路径；再通过echo $PATH查看是否包含该路径 - 临时解决方案：在
launch.json中硬编码runtimeExecutable，例如"runtimeExecutable": "C:Program Filesnodejsnode.exe"（注意使用双反斜杠或正斜杠）
program 和 runtimeExecutable 到底该分别指向哪里
这两个字段的作用不同，混用会导致调试失败或行为异常。
program指向你要运行的 JS 入口文件，例如"${workspaceFolder}/src/index.js"或"${file}"（当前编辑的文件）runtimeExecutable指向node二进制文件本身，仅当系统 PATH 不可靠时才需要显式设置；正常情况下留空即可- 如果同时设置了
runtimeExecutable和错误的program（比如把program写成node.exe路径），VSCode 会尝试用node去执行另一个node，从而报错Error: spawn node ENOENT - 常见错误配置：
"program": "${workspaceFolder}/node_modules/.bin/node"—— 这是 npm 的 wrapper 脚本，并不是真正的node二进制文件，调试器无法 attach
想“一键运行当前文件”，别只修改 program
很多人把 program 改成 "${file}" 就以为万事大吉，但漏掉了关键约束条件。
- 必须确保当前打开的文件是
.js文件，并且已经保存（未保存的临时文件没有真实路径） - 在无工作区的单文件模式下，不能使用
${workspaceFolder}，否则路径解析为空，导致program变成"/index.js"这类非法路径 - 推荐写法：
"program": "${file}"+"console": "integratedTerminal"，这样可以避免调试控制台输出乱码或截断 - 如果项目使用了
ts-node或esm，不要强行用type: "node"调试；应该改用type: "pwa-node"并配合runtimeArgs，例如["-r", "ts-node/register"]
真正容易被忽略的点是：VSCode 调试器启动时的环境变量与你终端里看到的可能不一致，尤其在 Windows 上，PATH 经常被截断或覆盖。与其反复折腾全局 PATH，不如在 launch.json 的 env 字段里补全关键路径，或者直接用 runtimeExecutable 指向绝对路径——简单、确定、一次生效。
