断点未触发是因为插件未激活，需检查activationevents配置、launch.json的type是否为"extensionhost"、package.json的main路径是否正确，以及命令注册与menus配置是否完全一致。
断点打在 activate 里却没触发？检查 activationEvents 和命令执行路径
VSCode 插件调试时断点不命中，最常见原因是 activate 函数根本没被调用——不是代码问题，而是插件没“激活”。activationEvents 决定插件何时加载，比如你配置了 "onCommand:myExtension.sayHello"，那只有在 Extension Development Host 窗口中真正执行该命令（Ctrl+Shift+P → 输入命令名 → 回车），activate 才会运行。
常见踩坑点：
-
launch.json中type写成"node"而非"extensionHost"：这会启动一个纯 Node 进程，完全绕过 VSCode 插件生命周期 -
package.json的main字段指向错误路径（如未编译的src/extension.ts），或out目录不存在 - 右键菜单项已注册，但没在 Extension Development Host 窗口里操作：你在主 VSCode 窗口右键，不会触发调试窗口里的插件逻辑
右键菜单显示了但点击无响应？确认 commands 和 menus 配置对齐
菜单项出现在资源管理器右键里，不代表命令就一定能执行。必须确保 package.json 中 contributes.commands 和 contributes.menus 的 command 字符串**完全一致**，包括大小写和命名空间（如 "myExtension.askQuestion"）。
实操要点：
- 在
extension.ts中用vscode.commands.registerCommand("myExtension.askQuestion", ...)注册，不能漏掉前缀 -
menus下的explorer/context或editor/context节点里，command值必须与注册名一字不差 - 如果加了
when条件（如"resourceScheme == file"），右键对象不满足条件时菜单会灰掉或不出现——可先去掉when快速验证逻辑
想测右键菜单行为，别直接跑 Jest
VSCode API（如 vscode.window.showInformationMessage）在普通 Node.js 环境下是 undefined，用 Jest 直接 import extension.ts 会立刻报错。单元测试只能覆盖纯逻辑函数（比如抽离出的字符串处理工具），而涉及菜单、命令、UI 交互的部分必须走真实环境。
官方推荐方案是 @vscode/test-electron：
- 它启动一个最小化 Electron 实例，注入 mock 的 VSCode API，能真实触发
activate和命令回调 - 测试脚本（如
test/runTest.ts）里必须调用runTests，并传入extensionDevelopmentPath和extensionTestsPath - 集成测试里可以模拟右键动作：用
vscode.workspace.getConfiguration()读取配置，或用vscode.commands.executeCommand()主动触发你的命令，再断言结果
调试时看不到变量值？重点查 launch.json 的 evaluateForHovers
即使断点命中断在命令回调里，变量面板也可能为空或显示 Cannot read property 'xxx' of undefined。这不是代码问题，而是调试器没被授权读取上下文。
必须在 .vscode/launch.json 的对应配置中显式启用：
-
"evaluateForHovers": true：允许鼠标悬停查看变量值 -
"showGlobalVariables": true（部分调试器支持）：让全局变量出现在“变量”面板 - 确保
outFiles包含生成的 JS 文件路径，例如"${workspaceFolder}/out/**/*.js"，否则 sourceMap 映射失败，调试器找不到源码位置
上下文变量只在调试暂停时有效；一旦继续执行（F5），变量面板就会清空或滞后——别指望它实时刷新。
