能跑 node 命令且 VSCode 可断点调试才算真正配好 Node 环境；首要验证是系统终端执行 node -v 和 npm -v 均输出版本号，否则说明 PATH 未配置正确，需重启 VSCode 并确认安装路径无中文或空格。
能跑 node 命令，且 VSCode 能断点调试，才算真正配好 Node 编译环境；其余插件、格式化、TypeScript 都是锦上添花，不是刚需。
验证 node 和 npm 是否真可用
很多人卡在第一步却以为是 VSCode 的问题。打开系统终端（不是 VSCode 内置终端），执行：
node -vnpm -v
必须都输出版本号。如果报错 'node' 不是内部或外部命令，说明 Node.js 没进系统 PATH：
- Windows 安装时漏勾
Add to PATH？手动把安装目录（如C:Program Files odejs）加进系统环境变量Path，然后**完全关闭并重启 VSCode** - Windows 别装在含中文或空格路径下（如
D:我的软件 odejs），否则npm可能静默失败 - macOS/Linux 用
nvm？确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，且新终端已加载
VSCode 调试器不依赖插件，但 launch.json 得配对
VSCode 自带 Node.js 调试支持，Node.js Extension Pack 这类插件现在已过时，装了反而可能冲突。确认 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 必须显式指定（多版本场景）
如果你用 nvm、fnm 或手动装了多个 Node 版本，VSCode 默认按 PATH 顺序找 node，很可能调用错版本，导致断点不触发、require 行为异常或源码映射失败。
在 .vscode/launch.json 的配置里加这一行：
"runtimeExecutable": "/usr/local/bin/node"（macOS/Linux）
或 "runtimeExecutable": "C:\nodejs\node.exe"（Windows）
验证是否生效：在代码里加 console.log(process.execPath)，对比终端里 which node 输出和调试器中打印的路径是否一致。
别用 Code Runner 直接跑模块化项目
Code Runner 插件默认用 node 执行 JS 文件，但它绕过项目上下文，不读 package.json 中的 "type": "module" 或 exports 字段，容易在 ES Module 场景下报错：Cannot use import statement outside a module。
正式开发中应：
- 禁用
Code Runner，或仅用于非模块化脚本（如单文件工具函数） - 统一用 VSCode 内置终端（
Ctrl+`）执行node index.js，行为与生产环境一致 - 若项目声明了
"type": "module"，确保文件扩展名是.mjs，或入口文件明确命名并被正确识别
最常被忽略的是：VSCode 终端是否继承了 shell 里已生效的 npm 配置。比如你在系统终端能用 nodemon，但在 VSCode 里提示 command not found，大概率是终端没读取 shell 配置文件——这时重启 VSCode 或手动在终端里执行 source ~/.zshrc 更直接。
