VSCode内置调试器深入解析-VSCode-PHP中文网

vs code 内置 node.js 调试器是内核级能力，非插件依赖；推荐默认使用 "type": "pwa-node"（而非 "node"），因其基于 chrome devtools-frontend 协议栈，对 es modules、source map 嵌套、worker 线程及动态 import() 支持更鲁棒，而老式 "node" 类型依赖 legacy v8 inspector，在模块解析、source map 回退和 worker 调试等场景易失效。

vscode内置调试器深入解析

VS Code 内置调试器不是“另一个插件”，它是编辑器内核级能力——Node.js 调试支持直接 baked in，不依赖外部扩展，launch.json 配置项中 type: "pwa-node" 或 "node" 才真正走这条路径；其他语言（Python、Java、C++）的调试必须靠对应扩展提供适配器，本质是 VS Code 调试协议（DAP）的客户端实现。

为什么 `type: "pwa-node"` 比 `"node"` 更值得默认用

VS Code 1.112 默认生成的是 pwa-node 类型配置，它基于 Chrome 的 devtools-frontend 协议栈重构，对 ES modules、source map 嵌套、Worker 线程、动态 import() 的支持更鲁棒。而老式 node 类型仍走 legacy V8 inspector 协议，在以下场景会掉链子：

调试 type: "module" 的 package.json 项目时，node 类型常报 Cannot find module 'xxx'，pwa-node 能正确解析 import.meta.url 和相对路径
使用 node --inspect-brk 启动但未指定 --enable-source-maps 时，pwa-node 仍能 fallback 到 inline source map 解析，node 类型直接放弃映射
在调试 Web Worker 时，pwa-node 支持自动附加到 spawned worker，node 类型需手动配置 attach 模式并监听额外端口

`launch.json` 里 `program` 和 `cwd` 的实际行为差异

很多人以为 program 就是“要运行的文件”，其实它决定的是 Node.js 进程启动时的 process.argv[1]，而 cwd 才真正影响模块解析根目录和 fs 操作的默认路径。常见陷阱：

VSCode 1.118

微软正式发布 Visual Studio Code 1.118 版本。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控。

下载

"program": "${workspaceFolder}/src/index.js" + "cwd": "${workspaceFolder}/dist" → Node 会从 /dist 目录加载 index.js，但 require('./utils') 会去 /dist/utils 找，而非 /src/utils
使用 ts-node 时，program 应设为 ts-node 入口（如 "${workspaceFolder}/node_modules/.bin/ts-node"），否则 VS Code 会尝试用 node 直接执行 .ts 文件，报错 Cannot use import statement outside a module
cwd 若未显式设置，默认为 workspaceFolder，但若你在子目录打开终端并 cd ../other-project 后启动调试，cwd 不会自动同步——它只读取配置，不继承 shell 当前路径

断点失效的三个隐蔽原因

断点变空心圆、灰色、或命中后不暂停，往往不是配置错误，而是底层机制被绕过：

source map 未生效：TS/JSX 编译后代码行号偏移，但 sourceMapPathOverrides 未正确映射。例如 Webpack 输出 webpack:///./src/main.ts，而你本地路径是 /Users/me/project/src/main.ts，需加配置："sourceMapPathOverrides": { "webpack:///./*": "${workspaceFolder}/*" }
代码被热替换（HMR）重载：React/Vite/HMR 场景下，断点打在原始模块，但运行时已被新模块实例替代。此时需启用 hotReload 支持（部分调试器支持），或改用 debugger; 语句配合条件断点
V8 优化跳过断点：V8 对短函数、循环体做内联或去优化，导致断点“消失”。可在 launch.json 加 "runtimeArgs": ["--no-opt"] 临时禁用优化，确认是否为此问题

真正难处理的，是那些不报错、不断点、但变量值始终不对的情况——这时候得切到调试控制台，手动执行 console.log(Object.getOwnPropertyDescriptors(obj))，看是不是 getter/setter 或 Proxy 在暗处搞鬼。内置调试器再强，也 debug 不了你自己写的魔法。