VSCode内置终端执行node命令前必须验证系统级可用性，即先在系统终端运行node -v和npm -v确认输出版本号，失败则重装Node并确保PATH正确（Windows勾选Add to PATH，macOS/Linux用code .启动以继承shell环境），否则VSCode无法调用node。
VSCode内置终端执行node命令前必须验证系统级可用性
不是VSCode没配好，而是它根本调不到node——所有失败都源于系统终端里node -v和npm -v没输出。VSCode内置终端（Ctrl + `）只是复用你系统shell的环境变量，它不会自己装Node.js，也不会自动读取你刚改的PATH。
必须按顺序实测：
- 关掉所有VSCode窗口，包括macOS Dock右键「退出」、Windows任务管理器确认
Code.exe已结束 - 打开系统终端（不是VSCode里的），运行
node -v和npm -v；失败就重装Node.js LTS，Windows务必勾选Add to PATH - 再双击图标启动VSCode，立刻按
Ctrl + `，输入node -v——这次有输出才算真正就位 - macOS/Linux用
nvm的，确认source ~/.zshrc已写入且新终端已加载；更稳的做法是直接在终端里执行code .启动项目
在VSCode终端里运行JS脚本的正确姿势
别点右上角▶️按钮，也别依赖code-runner插件——它不读package.json、不处理import、不转发环境变量，纯属“一键快感”，不适合真实开发。
最稳的方式就是把VSCode当普通终端用：
- 确保当前工作目录是项目根目录（即VSCode打开的文件夹），不是子文件夹
- 脚本路径必须是相对路径，比如
node index.js，不是node ./src/index.js（除非你在src目录下打开了终端） - ESM项目必须有
"type": "module"在package.json里，否则import会报Cannot use import statement outside a module - 含
process.stdin的脚本（如LeetCode输入模拟）在code-runner里必然假死，必须进终端手动运行
launch.json中program字段指向什么才有效
program不是写个路径就行，它必须指向一个能被node直接执行的真实JS文件，且上下文要匹配。
常见错误配置和对应解法：
- 单文件调试：
"program": "${file}"，但前提是当前打开的index.js本身就能跑（比如有console.log，没依赖未编译TS） - TypeScript项目：
program必须指向编译后的.js文件（如"${workspaceFolder}/dist/index.js"），且tsconfig.json里开了"sourceMaps": true - 用
npm start启服务："program": "npm"，"args": ["start"]，并加"console": "integratedTerminal"，否则日志全黑屏 - 绝对别写
"./src/index.js"——VSCode不解析.开头的相对路径，只认${workspaceFolder}这类变量
为什么F5调试时提示Cannot find runtime 'node'
这不是VSCode的错，是npm没到位。VSCode调试器底层靠npm启动脚本，npm -v失败，断点就永远加载不了。
排查重点不在launch.json，而在环境链路：
- 先确认系统终端里
npm -v有输出；如果失败，说明Node安装路径含中文/空格，或PATH漏加了node_modules/.bin - Windows用户特别注意：Node.js不能装在
C:\Program Files\nodejs这种带空格路径下，npm会静默失败 - 多Node版本共存（如nvm、volta）时，VSCode可能调用错版本；在
launch.json里显式加"runtimeExecutable": "/usr/local/bin/node"锁定路径 - 调试时加一句
console.log(process.execPath)，比对输出路径是否与runtimeExecutable一致，这是唯一可信验证方式
最易被忽略的是：VSCode不是运行环境，它只调用系统已有的node。哪怕装了十个插件，只要which node在系统终端里都找不到，一切调试和运行都是空中楼阁。
