F5启动后插件无反应是因为activationEvents未触发，需在Extension Development Host窗口手动执行命令才能运行activate函数、命中断点并输出日志。
F5 启动后插件没反应，不是代码问题，而是没触发激活事件——必须在 Extension Development Host 窗口中手动执行命令，才能让 activate 运行、断点命中、console.log 输出。
为什么 F5 启动后插件完全没动静
常见现象：按下 F5，弹出新窗口（Extension Development Host），但命令不出现、状态栏无图标、断点灰掉、控制台空空如也。
根本原因不是 extension.ts 写错了，而是 VS Code 没调用你的 activate 函数——因为 package.json 里声明的 activationEvents（比如 "onCommand:my-ext.doSomething"）还没被触发。
-
launch.json中request必须是"launch"，type必须是"extensionHost"；用"node"类型只会跑一个孤立 Node 进程，vscode API 全是undefined - 确保
package.json的main字段指向编译后的入口，例如"./out/extension.js"，且out目录已存在（TypeScript 编译后生成） - 如果插件注册了
"onStartup"，它会在窗口启动时自动激活；但绝大多数插件用的是"onCommand"或"onLanguage:javascript"，必须人工触发
断点不命中？先确认 sourceMap 和执行路径
断点打在 activate 里最直接，但前提是它真被调用了；打在命令回调里也行，但你得先在 Extension Development Host 窗口里按 Ctrl+Shift+P 输入命令名来触发。
- 检查
tsconfig.json：确保"sourceMap": true，且编译后每个.js文件旁都有对应.js.map -
launch.json中的outFiles必须包含"${workspaceFolder}/out/**/*.js"，否则调试器找不到源码映射 - 别在
deactivate里设断点指望它自动触发——它只在插件卸载时调用，而 VS Code 默认不会卸载你正在调试的插件 - 如果断点变灰（unbound），先查
out目录是否被.gitignore排除，导致调试器读不到.map文件
测试插件逻辑该不该写单元测试
要写，但不能直接用 Jest import extension.ts —— 因为 vscode.window、vscode.workspace 在普通 Node 环境下是 undefined，一跑就报错。
- 纯工具函数（不依赖 VS Code API）可抽离到独立模块，用 Jest 单独测，无需 mock
- 涉及命令注册、配置读取、消息弹窗等行为，必须用
@vscode/test-electron：它会拉起最小化 Electron 实例，并注入模拟的 VS Code API - 集成测试入口在
test/runTest.ts，必须调用runTests()并传入extensionDevelopmentPath和extensionTestsPath - 不要试图 mock
vscode全局对象来绕过 test-electron——mock 不完整会导致行为偏差，比如vscode.commands.registerCommand返回的 disposable 无法被正确 dispose
真正容易被忽略的是：插件调试不是“写完代码按 F5 就能跑”，它是一套严格依赖上下文加载顺序的流程。哪怕 package.json 里漏了一个逗号，或者 out 目录没生成，VS Code 都会静默跳过整个插件，连错误提示都不给。所以每次调试前，先确认三件事：out 目录存在、launch.json 类型正确、命令已在新窗口中手动触发过一次。
