断点不触发主因是 launch.json 中 program 路径错误或 cwd 不匹配，program 应为 "${workspacefolder}/out/extension.js"，cwd 必须是含 package.json 的插件根目录，并确保已编译且 sourcemap 配置正确。
断点加了但根本没停住？先查 launch.json 的 program 和 cwd
VS Code 调试插件时断点不触发，90% 是因为 launch.json 里 program 指向错误或 cwd 不匹配。插件开发用的是 Extension Development Host 启动方式，不是直接跑你写的 extension.ts —— 它实际加载的是编译后产物（如 out/extension.js），且依赖 cwd 正确才能解析 package.json 中的 main 字段。
实操建议：
-
program必须设为"${workspaceFolder}/out/extension.js"（不是src/下的 ts 文件） -
cwd必须是插件根目录（即含package.json的文件夹），不能是子目录或上层 workspace - 确认
out/目录存在且已编译：运行npm run compile或启用 TS 自动编译（Ctrl+Shift+B） - 如果用了 monorepo，
program路径要写全，比如"${workspaceFolder}/packages/my-extension/out/extension.js"
停在断点却看不到变量？检查 TypeScript 编译与 sourceMap 配置
插件用 TS 写，但调试时 Variables 面板为空、hover 看不到值、甚至报 Cannot find name 'xxx'，大概率是 sourceMap 映射断裂。VS Code 不会自动读取 tsconfig.json 里的 sourceMap，必须显式配进 launch.json。
实操建议：
- 确保
tsconfig.json含"sourceMap": true和"inlineSources": true（后者让源码嵌入 map，否则断点无法定位原始变量名） - 在
launch.json的配置中加"sourceMaps": true和"outFiles": ["${workspaceFolder}/out/**/*.js"] - 禁用 V8 优化：加
"runtimeArgs": ["--nolazy", "--no-opt"]，防止局部变量被内联消除 - 避免在
activate()外部定义顶层变量——它们可能被提升或未初始化，断点停住也读不到
异步链路（command → webview → api）里断点跳飞？用 debugger; + attach 模式补位
插件常见业务流是：用户点击命令 → 触发 registerCommand → 创建 Webview → Webview 发 postMessage → 插件侧监听并调用后端 API。这种跨上下文、跨进程的链路，纯行断点极易失效：Webview 运行在独立渲染进程，API 调用走 Node.js 子进程，断点根本挂不上。
实操建议：
- 在
webview.html的 JS 里关键位置插入debugger;，然后用 Chrome DevTools 手动 attach 到 Webview 窗口（地址栏输chrome-devtools://devtools/bundled/inspector.html?experiments=true&v8only=true&ws=127.0.0.1:9229/...） - 对子进程（如调用 Python 脚本或本地服务）单独建一个
attach类型的调试配置，用processId或port连接 - 在插件主进程的 message handler 里第一行加
debugger;，再配合 VS Code 的F5启动，比点断点更可靠 - 禁用
justMyCode: true（默认开启），否则 Webview 或第三方库的回调会被跳过
多 command 共享状态时逻辑错乱？监控全局对象变更而非单步跟踪
插件常把状态存在 context.globalState 或 context.workspaceState，多个 command 并发修改时，单步调试容易漏掉谁改了什么。你看到结果异常，但回溯不到哪次写入导致了问题。
实操建议：
- 不要只靠
Step Over跟 command 调用，改用「监视表达式」：在Watch面板加context.globalState.get('myKey')，实时看值变化 - 在
globalState.update()调用前统一加日志断点（右键断点 →「添加日志断点」），内容写"update {key} = {value}" - 对关键状态对象做浅拷贝快照：比如在
activate()里存一份初始值const initialState = {...context.globalState}，后续对比用 - 避免在
registerCommand回调里直接操作 DOM 或 Webview，这类副作用无法被断点捕获，必须拆成纯函数 + 显式触发
debugger; 和日志断点，比依赖 IDE 自动识别更可控。
