VSCode调试JS/Node.js无需插件但需正确配置launch.json:type必须为pwa-node(Node)或pwa-chrome(浏览器),request分launch(启动)和attach(连接),program路径须相对于工作区根,ESM需package.json设"type":"module",sourceMaps依赖构建产物含sourcemap,Node调试建议加"console":"integratedTerminal"。

VSCode 调试 JavaScript 和 Node.js 应用不需要额外安装插件(核心功能已内置),但必须正确配置 launch.json,否则断点不命中、控制台无输出、node 进程直接退出都是常见结果。
为什么断点没反应?检查 launch.json 的 type 和 request
VSCode 调试器靠 type 区分运行时环境:"type": "pwa-node" 是当前推荐的 Node.js 调试类型(取代旧版 node),而浏览器端 JS 必须用 "type": "pwa-chrome" 或 "pwa-msedge"。若混用或写错,调试器根本不会 attach。
-
request: "launch":用于启动新进程(如node index.js) -
request: "attach":用于连接已运行的进程(需提前加--inspect参数) - 浏览器调试必须配
url或file,且确保 DevTools 未手动禁用 JS
program 路径错误导致“Cannot find module”
VSCode 默认在工作区根目录执行 node,所以 program 值必须是相对于工作区根的路径,不是相对于 .vscode/ 或当前打开文件的位置。常见错误是写成 "./src/index.js" 却忘了工作区实际是上层目录。
- 用
${workspaceFolder}显式拼接更安全,例如"${workspaceFolder}/src/server.js" - 如果入口是 TypeScript,
program指向编译后的.js文件,不是.ts - Node.js 版本 ≥18.16 时,
type: "pwa-node"支持 ESM,但需确保package.json有"type": "module"或文件扩展名为.mjs
调试浏览器 JS 时 source map 不生效?确认 sourceMaps 和 outFiles
Webpack/Vite 等构建工具生成的 bundle 默认不带 inline source map,VSCode 就无法将压缩后代码映射回源码。关键配置不在 launch.json,而在构建输出本身。
立即学习“Java免费学习笔记(深入)”;
-
sourceMaps: true只是告诉调试器“去加载”,真正起作用的是构建产物中是否存在sourceMappingURL注释或.map文件 -
outFiles用于匹配生成的 JS 文件路径,例如["${workspaceFolder}/dist/**/*.js"];若留空或路径不匹配,断点仍打在 bundle 上 - Vite 用户注意:
build.sourcemap: true需显式开启,默认为false
最常被忽略的是:Node.js 调试中忘记在 launch.json 加 "console": "integratedTerminal",导致 console.log 输出不显示在 DEBUG CONSOLE 而是在终端里;浏览器调试中则容易漏掉 webRoot,导致断点无法解析本地文件路径。










