VS Code插件断点必须打在activate函数或命令回调里，因插件依赖activationEvents触发加载，未执行对应命令则activate不会调用；调试配置type必须为"extensionHost"、request为"launch"，且sourceMap和outFiles需正确配置以确保断点生效。
断点必须打在 activate 或命令回调里
VSCode 插件不会像普通 Node.js 脚本那样一启动就执行全部代码。它依赖 activationEvents 触发加载，比如 "onCommand:my-extension.doSomething" —— 没手动执行这个命令，activate 函数根本不会被调用，你打的断点自然不生效。
常见错误现象：F5 启动后弹出 Extension Development Host 窗口，但插件没反应、console.log 不输出、断点灰掉。
- 最稳妥的断点位置是
activate函数开头，确保插件已进入激活流程 - 命令回调（如
vscode.commands.registerCommand('my-extension.doSomething', ...)）里的断点也有效，但必须先在新窗口中按Ctrl+Shift+P输入命令名触发 - 别在
deactivate里设断点指望它自动触发——它只在插件卸载时运行，而调试中 VSCode 默认不会卸载你正在开发的插件
launch.json 的 type 和 request 必须匹配插件调试模式
用错调试类型会导致整个上下文丢失：进程跑起来了，但 vscode 全局对象是 undefined，registerCommand 失败，插件逻辑完全不加载。
正确配置只有一种：
-
type必须为"extensionHost"（不是"node"，也不是"chrome"） -
request必须为"launch" -
main字段在package.json中要指向编译后的入口文件（如./out/extension.js），且out目录必须存在 -
outFiles在launch.json中需包含"${workspaceFolder}/out/**/*.js"，否则 sourceMap 找不到映射
源码断点失效？检查 sourceMap 和 out 目录可见性
TypeScript 断点打在 .ts 文件里却不起作用，90% 是因为调试器找不到 .js.map 文件或无法关联源码。
关键检查点：
-
tsconfig.json中"sourceMap": true必须开启，且编译后每个.js文件同级要有对应.js.map -
out目录不能被.gitignore屏蔽——VSCode 调试器读不到被忽略的文件，断点会 unbound - 如果用了构建工具（如 webpack），确认其生成的 sourcemap 路径正确指向原始 ts 文件，而非相对路径错乱
测试逻辑别直接 import 插件主文件
在 Jest/Vitest 里写 import * as ext from '../src/extension' 会立刻报错：vscode.window is undefined。VSCode API 只在 Extension Development Host 或 @vscode/test-electron 环境中可用。
可行方案分两层：
- 纯计算逻辑（如字符串处理、配置解析）抽离到独立模块，脱离
vscode依赖后用 Jest 直接测 - 涉及命令注册、状态管理、配置读取等集成行为，必须走
@vscode/test-electron启动 mock host，并在test/runTest.ts中调用runTests，传入extensionDevelopmentPath和extensionTestsPath
真正容易被忽略的是：哪怕只是调用了一个带 vscode.workspace.getConfiguration() 的函数，也必须进 test-electron 流程——没 mock 的 API 调用就是 runtime error。
