VSCode本身不带Node.js，node命令在终端报错是因系统未将Node.js路径加入PATH；Windows需安装时勾选“Add toPATH”或手动添加C:\Program Files\nodejs到系统环境变量，验证须在全新CMD中执行node -v和npm -v，有输出且重启VSCode后才生效。
VSCode 本身不带 Node.js，node 命令在终端里跑不通，后面所有操作都会失败——这是 90% 新手卡住的根源。
node -v 报错：'node' 不是内部或外部命令
这不是 VSCode 的问题，而是系统没把 Node.js 加进 PATH。Windows 用户装 .msi 包时漏选 “Add to PATH” 是最常见原因；ZIP 版或手动改过安装路径的，必须手动把 node.exe 所在目录（比如 C:\Program Files\nodejs）加到系统环境变量 Path 里。
- 验证方式：关掉所有 VSCode 窗口，打开全新 CMD 或 PowerShell，执行
node -v和npm -v—— 有输出才算真正装好 - 装完必须重启 VSCode（不是只关终端），否则它读不到新 PATH
- 避免中文路径或空格路径，比如
C:\我的软件\nodejs或C:\Program Files (x86)\nodejs容易导致npm静默失败
VSCode 内置终端能跑 node，但右键“Run Code”失败
Code Runner 插件默认用简陋命令执行，不处理模块类型、编码、输入流，也不读 package.json 中的 "type": "module" 设置，极易出错。
- 中文 Windows 下常乱码：在 VSCode 设置里搜
code-runner.executorMap，把javascript对应值改成：node -r utf-8 $fileName - ESM 项目（用了
import）报Cannot use import statement outside a module：确保package.json里有"type": "module"，再把 executor 改成：node --experimental-specifier-resolution=node $fileName -
process.stdin读不到输入：Code Runner 不支持交互式 stdin，要么换到集成终端手敲node app.js，要么用 F5 调试模式
F5 调试断点不生效或提示 “Cannot find runtime 'node'”
VSCode 调试器依赖 node 可执行文件路径，也严格按 CommonJS/ESM 规则解析代码。launch.json 配错一个字段，整个调试就挂。
- 先确认
node -v在 VSCode 终端里能跑通；否则Cannot find runtime 'node'是必然结果 - 单文件调试最稳：按
Ctrl+Shift+P→ 输入Debug: Open Configuration→ 选Node.js → Current File，生成的launch.json里"program": "${file}"就行 - 入口不是当前文件？比如主文件叫
server.js，就得手动改成"program": "${workspaceFolder}/server.js"，别留默认的index.js - 用
nodemon热重载？不能直接在 launch.json 里设"program": "nodemon"—— 调试器不支持热替换，得用 attach 模式：nodemon --inspect-brk server.js启动后，在 launch.json 里配"request": "attach"和"port": 9229
真正容易被忽略的是：VSCode 终端是否继承了 shell 的完整环境。比如 macOS 上用 zsh 配了 nvm，但从 Dock 启动 VSCode 就不加载 ~/.zshrc；更可靠的做法是关掉 VSCode，从终端执行 code . 打开项目。
