断点不生效主因是未启动调试会话或launch.json配置错误；ts断点偏移需校准sourcemaps与outfiles；条件断点受限于作用域；变量不可见需检查justmycode和调试器版本。
断点不生效？先确认调试会话是否真正启动
VSCode插件开发中，launch.json 配置错误或误用“运行”而非“调试”是断点失效的主因。点行号左侧加红点只是标记位置，不启动调试会话（按 F5 或点击 ▶️ 图标），断点完全无响应。
常见错误现象包括：红点始终为空心、控制台无调试日志、代码照常执行。此时务必检查：Run and Debug 侧边栏是否已选中一个有效配置；若列表为空，必须先点击齿轮图标生成 .vscode/launch.json，不能跳过这步。
-
type字段必须为extensionHost（不是node或chrome） -
request必须是launch，且program指向${workspaceFolder}/src/extension.ts（或实际入口 TS 文件） -
outFiles和sourceMaps必须启用，否则断点会偏移到编译后的extension.js行号上
TS源码断点偏移？盯紧 sourceMaps 和 outFiles 配置
TypeScript 插件项目里，你在 extension.ts 第 42 行设了断点，结果停在 extension.js 第 18 行甚至跳过——这不是 VSCode 故障，是源码映射没对齐。
确保 tsconfig.json 中同时满足："sourceMap": true、"inlineSourceMap": false（VSCode 更依赖独立 .map 文件），且 "outDir" 与 launch.json 中的 outFiles 路径一致。
-
outFiles示例值：["${workspaceFolder}/out/**/*.js"] - 构建命令必须执行
tsc -b 或 <code>npm run compile，确保.js和.js.map同时生成并落进outFiles路径内 - 如果用
webpack打包，需额外配置devtool: 'source-map'并验证.map文件真实存在
条件断点怎么写？作用域和表达式求值有边界
插件开发调试中高频使用循环或事件监听器，硬等断点触发极耗时间。右键行号 → Add Conditional Breakpoint 是刚需，但表达式写错会导致断点静默失效。
关键限制在于作用域：条件表达式只能访问当前函数作用域内已声明的变量，不能跨函数引用局部变量，也不能调用未导出的私有工具函数。
- 合法示例：
context.extensionPath.includes("my-ext")（context是activate函数参数） - 非法示例：
utils.isValid()（utils未在当前作用域定义）或i === 100（i在外层 for 循环中声明，但断点设在异步回调内） - 支持完整布尔逻辑：
event.type === "onCommand" && event.commandId === "myExt.doSomething"
调试 extensionHost 时无法查看变量？检查 justMyCode 和调试器版本
插件调试过程中，“Variables”面板为空或只显示 undefined，大概率是 justMyCode 过度过滤或调试器未正确加载扩展上下文。
justMyCode: true（默认）会隐藏 node_modules 和 VSCode 内部模块的变量，这对聚焦业务逻辑有利，但有时需要关掉才能看到底层对象结构。更隐蔽的问题是调试器版本不匹配：VSCode 1.89+ 对 extensionHost 调试协议做了调整，旧版 @vscode/test-electron 可能不兼容。
- 临时解决：在
launch.json中设"justMyCode": false，再观察变量面板 - 验证调试器：运行
npx @vscode/test-electron@latest确保本地安装的是最新版 - 避免在
deactivate函数里设断点——该函数由 VSCode 主进程调用，extensionHost调试器通常无法捕获其上下文
extensionHost 调试会话启动后，VSCode 会拉起一个独立的 Extension Development Host 窗口，所有断点只在这个窗口的上下文中生效——你正在编辑的原始窗口本身并不参与调试。
