VSCode集成终端能执行node命令并命中断点才算真正运行；需重启VSCode使PATH生效，验证node/npm版本，配置launch.json时指定runtimeExecutable并同步环境变量。
能直接在 VSCode 集成终端里执行 node 命令、看到控制台输出、且后续调试断点可命中，才算真正跑起来——不是靠 Code Runner 插件右键“Run Code”那种隔离上下文的假运行。
验证 node 和 npm 是否真被 VSCode 终端识别
这是最关键的前置动作。VSCode 启动时读取的是系统 PATH 快照，改完环境变量不重启 VSCode，内置终端就永远找不到 node。
- 关掉所有 VSCode 窗口（macOS 在 Dock 右键选「退出」；Windows 在任务管理器确认
Code.exe已结束） - 打开系统原生命令行（不是 VSCode 终端），执行：
node -v和npm -v—— 两个都必须输出版本号 - 若失败：Windows 用户检查安装 Node.js 时是否勾选了
Add to PATH；macOS/Linux 用nvm的，确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，并新开终端验证 - 再打开 VSCode，按
Ctrl + `打开集成终端，立刻执行node -v—— 这次的结果才代表它真正可用
在集成终端中直接启动服务（非调试场景）
适合快速验证逻辑、预览静态资源或跑一次性的脚本。不要依赖插件，避免上下文错乱。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 确保项目根目录下有入口文件（如
index.js或server.js） - 在集成终端中执行：
node index.js（CommonJS）或node --loader ts-node/esm index.ts（TS+ESM） - 如果项目用了
"type": "module"，但文件后缀是.js，会报Cannot use import statement outside a module—— 此时要么改后缀为.mjs，要么显式加--input-type=module - 想自动重启？别在终端里直接跑
nodemon，先装本地依赖：npm install --save-dev nodemon，再跑：npx nodemon index.js
用 launch.json 启动服务（需调试/断点）
默认生成的 "program": "${file}" 只适用于单文件执行，跑 Express/Koa/带 package.json 脚本的服务必须改配置，否则断点无效、日志不输出。
- 按
Ctrl + Shift + P→ 输入Debug: Open Configuration→ 选Node.js，生成.vscode/launch.json - 把
"program"改成"npm"，加"args": ["start"]，再加"console": "integratedTerminal"，否则npm start的日志不会出现在调试控制台 - 确保
package.json里有"scripts": {"start": "node index.js"}或"start": "nodemon index.js" - 别把
"program"指向nodemon本身——VSCode 调试器不支持热替换，nodemon必须走 attach 模式
runtimeExecutable 不配等于没调试
系统里有多个 Node.js 版本（比如 nvm 切换过、或手动装了多个）时，VSCode 默认按 PATH 找到的 node，可能和你在终端里敲 node -v 看到的不是同一个。
- 在
launch.json的配置项里显式指定"runtimeExecutable"，例如："runtimeExecutable": "/usr/local/bin/node"（macOS/Linux）或"runtimeExecutable": "C:\nodejs\node.exe"（Windows） - 加一句
console.log(process.execPath)在代码里，对比输出路径是否与runtimeExecutable一致 - 不写这个字段，断点可能不触发、
require行为异常、源码映射失败，问题极难定位
最常被忽略的是 runtimeExecutable 和环境变量同步时机——PATH 改了不彻底关 VSCode，或者多版本共存却没锁定解释器路径，这两点会让调试行为变得完全不可预测。
