VSCode插件单元测试必须mock vscode全局对象，因其API在Node.js环境下不存在，直接import会报ReferenceError；需手动mock workspace、window等常用对象并确保返回值结构完整，同时拆分activate逻辑、配置ts-jest预设、覆盖异步边界及ExtensionContext生命周期。
VSCode 插件单元测试必须 mock vscode 全局对象
不 mock 就跑不起来——vscode API 在 Node.js 环境下根本不存在，直接 import 会报 ReferenceError: vscode is not defined。Jest 默认只运行 JS/TS 逻辑，不会自动注入编辑器环境。
- 必须在每个测试文件顶部或
setupFilesAfterEnv中手动 mock：jest.mock('vscode', () => ({ ... })) - 重点 mock 常用对象：
workspace、window、commands、extensions，否则调用vscode.window.showInformationMessage这类方法会直接 throw - 不要只 mock 函数，也要 mock 返回值结构（比如
TextDocument必须有uri、getText()方法），否则下游逻辑可能因属性缺失而 fail - 避免在 mock 里写真实业务逻辑；mock 是“假接口”，不是“简化版实现”
如何让 activate 函数在测试中可执行
activate 通常依赖完整 ExtensionContext 和 VSCode 生命周期，但单元测试里不能等编辑器启动。硬调用会因 context.subscriptions 或 context.globalState 未初始化而崩溃。
- 把
activate拆成纯函数：提取核心逻辑到独立函数（如registerCommands(context)），该函数只接收必要参数，不依赖context的深层属性 - mock
ExtensionContext时，至少提供：subscriptions: []、globalState: { get: jest.fn(), update: jest.fn() }、extensionPath: '/fake/path' - 别 mock
context.extensionUri为undefined——很多插件用它拼配置路径，会导致path.join报错 - 如果插件用了
context.workspaceState，需同步 mock 其get/update，否则配置读写测试会静默失败
Jest 配置里漏掉 ts-jest preset 就无法解析 .ts 测试文件
VSCode 插件几乎全是 TypeScript，但 Jest 默认不支持 TS 语法。没配 ts-jest 会导致测试文件被跳过，且无任何提示——npm test 显示 “No tests found”，而不是报错。
- 确认
jest.config.js包含：preset: 'ts-jest'、testEnvironment: 'node'、transform: { '^.+\.tsx?$': 'ts-jest' } - 若项目用了
paths别名（如@src/*），必须在ts-jest的compilerOptions或tsconfig.json中同步配置，否则import会报错 -
moduleNameMapper要映射vscode到 mock 文件（如'vscode': '<rootdir>/tests/mocks/vscode.ts'</rootdir>），否则 jest 仍会尝试加载真实模块并失败 - TS 类型仅用于开发期检查，测试运行时类型擦除，所以 mock 返回值类型不必完全对齐，但结构必须可用
测试覆盖率高 ≠ 功能可靠，关键路径必须覆盖异步边界
VSCode 插件大量使用 Promise、event、delay，单纯测 resolve 分支容易漏掉 reject、timeout、cancel 场景。覆盖率工具（如 jest --coverage）只统计行数，不识别逻辑分支是否真被触发。
- 显式测试
await失败路径：用jest.mock让workspace.openTextDocument抛出错误，验证插件是否正确处理异常 - 模拟用户取消操作：mock
window.showQuickPick返回undefined，检查命令是否提前退出而不 crash - 避免用
setTimeout模拟 delay——Jest 提供jest.useFakeTimers()+jest.runAllTimers()更可控 - 所有
vscode.commands.executeCommand调用必须被 mock 并断言是否被调用，否则无法确认 UI 交互链路是否打通
ExtensionContext 的生命周期语义——它不是普通对象，其 subscriptions 数组在插件卸载时会被遍历 dispose。单元测试中若漏掉对它的清理断言，集成测试阶段就可能因资源泄漏导致随机失败。 
