VS Code调试Node.js无需插件但需正确配置launch.json；必须验证Node.js已安装且VS Code能识别，program路径须用${workspaceFolder}相对路径，区分launch与attach模式，常见失败原因包括路径错误、断点位置无效或调试器未连接。
VS Code 调试 Node.js 应用不需要额外安装插件（内置支持），但必须正确配置 launch.json，否则会报 Cannot launch program because corresponding JavaScript file cannot be found 或直接启动失败。
确认 Node.js 已正确安装并被 VS Code 识别
VS Code 本身不自带 Node.js，它依赖系统 PATH 中的 node 命令。调试前务必验证：
- 终端中执行
node -v和npm -v能正常输出版本号 - 在 VS Code 内置终端（
Ctrl+`）中运行同样命令，结果一致；若不一致，说明 VS Code 没读到你的 shell 配置（如 zshrc、bash_profile），需重启 VS Code 或手动修改terminal.integrated.env.*设置 - 某些 M1/M2 Mac 用户遇到
zsh: command not found: node，通常是通过 Homebrew 安装但未链接，运行brew link node即可
launch.json 中 program 路径必须是相对工作区根目录的路径
VS Code 的调试器以当前打开的文件夹（即 workspace root）为基准解析 program。常见错误是写成绝对路径或误用 __dirname 这类运行时变量——它们在 launch.json 中完全无效。
- 正确写法：
"program": "${workspaceFolder}/src/index.js" - 错误写法：
"program": "./src/index.js"（VS Code 不支持 POSIX 相对路径前缀./） - 错误写法：
"program": "src/index.js"（缺少${workspaceFolder}，会被解释为相对于 VS Code 安装目录） - 如果入口文件是 TypeScript，需先确保已配置
preLaunchTask或使用ts-node，此时program应指向ts-node，而非.ts文件
区分 launch 和 attach 两种调试模式
绝大多数本地开发场景应使用 launch 模式（自动启动 Node 进程并注入调试器）。只有当你需要调试已运行的进程（比如用 npm start 启动的服务，或 Docker 容器内进程），才用 attach。
-
launch必须指定program；attach必须指定port（默认 9229），且目标进程需带--inspect启动，例如：node --inspect=0.0.0.0:9229 index.js - 使用
attach时，address字段仅在跨网络调试（如 WSL、容器）时需要设置；本地调试留空即可 - VS Code 1.85+ 对
attach模式增加了自动端口探测，但不稳定，建议显式指定port
常见调试失败原因与快速验证步骤
按下 F5 没反应、断点灰掉、控制台无输出——别急着重配，按顺序检查这几项：
- 当前打开的文件夹是否真的是项目根目录？
package.json是否在该目录下？ - 断点是否打在可执行代码行上？
import、const声明、空行、注释行无法设断点 - 是否误启用了“跳过所有断点”？看调试工具栏右侧图标是否为禁用状态（灰色圆点）
- 终端里是否有
Debugger attached.提示？没有说明调试器根本没连上，重点查port冲突或防火墙拦截（尤其 Windows Hyper-V/WSL2 场景） - 如果用
nodemon，不要在launch.json中直接调nodemon；应改用preLaunchTask启动，或启用nodemon --inspect并切到attach模式
最常被忽略的是 program 路径的上下文和 workspaceFolder 的实际位置——花 30 秒在资源管理器里右键“在终端中打开”，然后 pwd 确认当前路径，比反复改配置更有效。
