VSCode插件集成函数单元测试运行环境-VSCode-PHP中文网

vscode插件单元测试必须mock vscode全局对象，因其api在node.js环境不存在，直接import会报referenceerror；需手动mock workspace、window等对象并确保返回值结构完整，拆分activate逻辑、配置ts-jest预设、覆盖异步边界及extensioncontext生命周期。

vscode插件集成函数单元测试运行环境

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 未初始化而崩溃。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

把核心逻辑（如注册命令、监听事件）抽到独立函数，例如 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 里排除了

复杂点在于 mock 的深度和一致性：一个 vscode.workspace.getConfiguration() 返回的对象，其 get 方法返回值类型、嵌套结构、甚至可选属性，都得跟真实 API 对齐，否则下游断言可能因字段缺失而 fail，但错误堆栈不会指向 mock 不完整，而是指向你自己的业务代码。