能直接在VSCode终端执行node -v和npm -v且F5调试断点生效才算配通；必须在系统终端验证双版本号，PATH修改后须完全重启VSCode，调试需在launch.json中显式配置runtimeExecutable。
能直接在 VSCode 终端里执行 node -v 和 npm -v，且 F5 调试时断点生效，才算真正配通——其余全是锦上添花。
验证 node 和 npm 是否真可用，别信安装界面勾选了就完事
很多“跑不起来”问题，根源是 node 命令在 VSCode 里根本找不到。关键不是看安装程序有没有勾选“Add to PATH”，而是看它是否真的进了系统环境变量，并被 VSCode 加载。
- 必须在系统终端（Windows 是 CMD 或 PowerShell，macOS/Linux 是 Terminal）里运行
node -v和npm -v，两个都输出版本号才算过关 - 如果失败：
– Windows 用户检查“系统属性 > 高级 > 环境变量”，确认Path里包含 Node.js 安装路径（如C:Program Files odejs），且路径不含中文或空格
– macOS/Linux 用nvm的，确保source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，并新开终端验证
– 所有平台改完环境变量后，必须完全退出 VSCode 再重开，否则内置终端仍继承旧环境
用内置终端跑脚本，别依赖 Code Runner 插件
Code Runner 默认调用 node 执行单文件，但它绕过 package.json 的配置，容易在 ES Module 场景下报 Cannot use import statement outside a module。
- 日常开发一律用 VSCode 内置终端（
Ctrl + `）执行node index.js，行为与真实部署一致 - 若项目设了
"type": "module"，确保文件扩展名是.mjs，或在package.json中明确声明，否则node仍按 CommonJS 解析 -
Code Runner的Ctrl+Alt+N仅适合快速验证纯函数逻辑，一旦涉及模块导入、exports或type字段，立刻失效
调试必须靠 launch.json，且 runtimeExecutable 得显式写死
VSCode 自带 Node.js 调试支持，不需要额外装 Debugger for Node.js 这类过时插件。但默认生成的 launch.json 在多 Node 版本环境下极易出错。
- 按
Ctrl+Shift+P→ 输入Debug: Open Configuration→ 选Node.js: Current File，VSCode 自动生成.vscode/launch.json - 务必手动添加
"runtimeExecutable"字段，指向你实际想用的node可执行文件路径：
– Windows 示例："runtimeExecutable": "C:\Program Files\nodejs\node.exe"
– macOS/Linux 示例："runtimeExecutable": "/usr/local/bin/node" - 不加这个字段，VSCode 会按
PATH顺序找node，而它找到的版本很可能和你在终端里which node看到的不一样 - 验证方式：在代码里加
console.log(process.execPath)，对比调试器输出路径是否与runtimeExecutable一致
npm -v 成功才是调试器工作的硬前提
VSCode 调试器底层依赖 npm 启动脚本（比如 npm start 或 npm run dev），npm -v 失败会导致调试直接报 Cannot find runtime 'node'，哪怕 node -v 是好的。
-
npm -v报错，90% 是因为 Node.js 安装不完整或权限问题（尤其 macOS 上用sudo npm install后遗症） - Windows 用户常见陷阱：Node.js 装在
C:Program Files odejs，但npm全局 bin 目录（如C:UsersXXXAppDataRoaming pm）没进Path，导致npm命令不可见 - 修复方法：重新运行 Node.js 安装程序，勾选“Automatically install the necessary tools”，或手动把 npm 全局 bin 路径加入
Path
最常被忽略的其实是环境变量刷新机制——VSCode 不会动态监听系统 PATH 变更，改完变量不重启编辑器，等于没改。这点在团队协作或切换 Node 版本时尤为致命。
