真正搭好Node开发环境需同时满足终端可运行node/npm且VSCode能断点调试；先在系统终端执行node -v和npm -v验证版本，再配置launch.json的runtimeExecutable确保调试器使用正确Node路径。
能跑 node 命令，且 VSCode 能断点调试，才算真正搭好了 Node 开发环境；其余插件、格式化、TypeScript 都是锦上添花，不是刚需。
验证 node 和 npm 是否真可用
很多人卡在这一步，却以为是 VSCode 的问题。必须在系统终端（不是 VSCode 内置终端）里执行：
node -vnpm -v
两个命令都输出版本号才算过关。如果报错 'node' 不是内部或外部命令，说明 Node.js 没进系统 PATH：
- Windows 安装 LTS 版时务必勾选 Add to PATH；漏了就得手动把安装目录（如
C:Program Files odejs）加到系统环境变量Path里，然后彻底关闭并重启 VSCode - Windows 用户别装在含中文或空格的路径下（如
D:我的软件 odejs），否则npm可能静默失败 - macOS/Linux 用
nvm的，确保source ~/.nvm/nvm.sh已写入 shell 配置（~/.zshrc或~/.bash_profile），且新终端已加载
npm -v 必须成功——VSCode 调试器底层依赖 npm 启动脚本，不是可选项。
立即学习“前端免费学习笔记（深入）”；
VSCode 内置调试器直接可用，别装过时插件
VSCode 自带 Node.js 调试支持，Node.js Extension Pack 或 Debugger for Node.js 这类插件现在已过时，装了反而可能冲突。
确认 node 可用后，只需三步：
- 新建项目文件夹，在其中创建
index.js，写一行console.log('ok'); - 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Debug: Open Configuration，选择Node.js → Current File - VSCode 会自动生成
.vscode/launch.json，内容含"program": "${file}"—— 表示“运行当前打开的 JS 文件”
此时在代码行号左侧单击设断点，按 F5 即可启动调试。若提示 Cannot find runtime 'node'，一定是第一步的 node 环境没配好，不是 VSCode 设置问题。
launch.json 中 runtimeExecutable 必须显式指定（多版本场景）
本地有多个 Node.js 版本（比如用 nvm 或手动装了多个版本）时，VSCode 默认按 PATH 顺序找 node，可能调用错版本，导致断点不触发、源码映射失败或 require 行为异常。
解决方法：在项目根目录的 .vscode/launch.json 中，给配置项加上 runtimeExecutable 字段：
- macOS/Linux：
"runtimeExecutable": "/usr/local/bin/node"（或nvm对应路径，如"~/.nvm/versions/node/v18.17.0/bin/node"） - Windows：
"runtimeExecutable": "C:\Program Files\nodejs\node.exe"
验证方式：在代码里加一行 console.log(process.execPath)，对比调试器里打印的路径是否与 runtimeExecutable 一致。
别用 Code Runner 插件跑模块化脚本
Code Runner 默认用 node 执行 JS 文件，但它绕过项目上下文，不加载 package.json 中的 type 字段或 exports 配置，容易在 ES Module 场景下报错 Cannot use import statement outside a module。
正确做法：
- 用 VSCode 内置终端（
Ctrl+`）执行node index.js，行为与真实部署环境一致 - 若项目声明了
"type": "module"，确保文件扩展名是.mjs，或在package.json中明确写"type": "module"，否则node仍按 CommonJS 解析
Code Runner 的快捷键（Ctrl+Alt+N）适合快速验证单文件逻辑，但正式开发中应禁用或仅用于非模块化脚本。
最常被忽略的其实是 runtimeExecutable 和 process.execPath 的比对——很多断点失效、import 报错、甚至 fs.readFileSync 路径异常，根源都在这里。
