VSCode插件单元测试必须mock vscode全局对象，因其API在Node.js环境不存在，直接import会报ReferenceError；需手动mock workspace、window等对象并确保返回值结构完整，拆分activate逻辑、配置ts-jest预设、覆盖异步边界及ExtensionContext生命周期。
vscode全局对象不mock就ReferenceError
直接 import vscode 在 Jest 里必然报 ReferenceError: vscode is not defined——这不是代码写错了，是环境根本不存在。VSCode 插件的 API 全部依赖编辑器宿主进程，Node.js 环境里连 vscode 这个全局变量都没有。
- 必须在每个测试文件顶部或
setupFilesAfterEnv中显式 mock：jest.mock('vscode', () => ({ ... })) - 只 mock
vscode.window.showInformationMessage这种函数不够，下游逻辑可能调用document.getText()，就得确保 mock 返回的TextDocument有uri和getText方法 - 别在 mock 里写真实业务逻辑，比如用真实 fs 操作读配置——mock 是接口契约，不是简化版实现
activate函数不能硬调用，得拆成纯函数
activate 通常绑着 ExtensionContext 的生命周期，但 Jest 里没有真实 context，硬调会因 context.subscriptions 或 context.globalState 未初始化而崩溃。
- 把核心逻辑（如注册命令、监听事件）抽到独立函数，例如
registerCommands(context: ExtensionContext)，参数只收必要字段 - mock
ExtensionContext至少提供：subscriptions: []、globalState: { get: jest.fn(), update: jest.fn() }、extensionPath: '/fake/path' - 别漏掉
extensionUri，很多插件用它拼路径，mock 为undefined会导致path.join报错 - 如果用了
context.workspaceState，也得 mock 其get/update，否则配置读写测试静默失败
ts-jest 配置漏掉就“No tests found”
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中同步配置 -
moduleNameMapper要映射vscode到本地 mock 文件，例如'vscode': '<rootdir>/tests/mocks/vscode.ts'</rootdir>，否则 Jest 还是会尝试加载真实模块并失败
测试文件里 import vscode 仍报错？检查 moduleNameMapper 路径
即使写了 jest.mock('vscode')，如果 moduleNameMapper 没配对，Jest 仍会按原路径去找 vscode 包，而它根本不在 node_modules 里，最终还是 Cannot find module 'vscode'。
- 确认
moduleNameMapper的 key 是精确字符串'vscode'，value 是相对于<rootdir></rootdir>的绝对路径，且该路径下确实存在 mock 文件 - mock 文件里不要 export default，要按真实
vscode的命名导出，比如export const workspace = { ... }、export const window = { ... } - 如果 mock 文件用了相对路径导入其他工具（如
path），确保这些依赖也在 Jest 的transformIgnorePatterns里排除了
vscode.workspace.getConfiguration() 返回的对象，其 get 方法返回值类型、嵌套结构、甚至可选属性，都得跟真实 API 对齐，否则下游断言可能因字段缺失而 fail，但错误堆栈不会指向 mock 不完整，而是指向你自己的业务代码。 
