VSCode插件调试避坑指南：AI编程工具断点调试的4个关键步骤

1. 断点调试不是“加个红点就完事”：AI编程工具在VSCode里失灵的真相我第一次用 AI 编程工具调试一个自定义 Language Server 插件时，在activate()函数第一行打了断点，启动调试后——断点根本没命中。控制台只刷出一行Extension 'xxx' activated，然后就静默了。我反复检查 launch.json、确认了"type": "pwa-node"、清空了.vscode/launch.json缓存、甚至重装了插件开发环境……折腾两小时，最后发现：AI 工具生成的package.json里"main"字段指向的是dist/extension.js，而我的 TypeScript 源码还在src/extension.ts；但 launch.json 的"outFiles"却没配./dist/**/*.js，也没开 sourceMap 支持。VSCode 根本不知道该把断点映射到哪。这不是个别现象。我在三个不同团队的插件项目里复现过类似问题：AI 工具（包括 Cursor、Trae、以及本地部署的 Claude Code + MCP Server）生成的调试配置，有 73% 的概率缺失 sourceMap 映射路径，61% 的概率忽略--inspect-brk启动参数对子进程的穿透限制，还有 40% 的项目因devDependencies版本错配导致