使用vscode-extension-tester时扩展无法加载，如何排查原因？

云原生阿岚

2026-6-12

调试vscode-extension-tester无法加载扩展的方法

针对你遇到的vscode-extension-tester无法加载扩展的问题，可按以下步骤排查：

检查VS Code版本兼容性
vscode-extension-tester对VS Code版本有严格对应要求，不同版本的测试工具仅支持特定范围的VS Code。执行npm list vscode-extension-tester查看当前测试工具版本，对照官方说明确认兼容的VS Code版本。也可在测试命令中强制指定VS Code版本，例如：
```
npm run test -- --vscode-version 1.85.0
```
启用全量调试日志
默认日志级别可能无法展示加载细节，通过设置环境变量开启全量日志：
```
DEBUG=* npm run test
```
查看日志中是否有扩展复制、安装、加载阶段的详细信息，比如是否提示扩展包不存在、权限问题等。
手动检查测试实例的扩展状态
在测试代码的初始化阶段添加延迟，让测试实例有足够时间加载：
```
await new Promise(resolve => setTimeout(resolve, 5000));
```
运行测试时，手动打开测试实例的扩展面板（Ctrl+Shift+X），确认你的扩展是否出现在列表中，是否被禁用，或是否有加载失败的提示信息。
验证测试工作区的扩展安装情况
vscode-extension-tester会在临时目录创建独立的VS Code测试实例，通过DEBUG日志找到该临时目录路径，进入extensions文件夹检查是否存在你的扩展包。若不存在，确认测试脚本是否在执行前完成了扩展打包（如vsce package），确保打包产物路径正确。
核对依赖版本与示例项目一致
即使配置文件结构一致，依赖版本差异也可能导致问题。将你的package.json中vscode、vscode-extension-tester、mocha等核心依赖的版本，与示例项目完全对齐，重新执行npm install后再测试。