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。
Eclipse中创建Web Maven Project并部署到Tomcat中 中文WORD版
下载
大家都知道，在进行J2EE项目的开发过程中，在调试阶段如果只是修改了页面是不需要重启应用服务器的，比如不需要重启Tomcat。只需要在浏览器中 进行页面刷新即可。其实之所以不用重启Tomcat等应用服务器，其根本原因是因为我们可以在应用服务器的配置文件中设置虚拟目录，这样就可以知道web 项目所在的目录，于是就可以省去打包、然后再重新发布到服务器的步骤。感兴趣的朋友可以过来看看
-
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 确认当前路径，比反复改配置更有效。
