如何让VSCode扩展兼容旧版本及解决测试运行异常问题

1. 调整测试启动配置（launch.json） #

找到项目根目录下的.vscode/launch.json，修改测试项的配置，强制指定目标VSCode版本：

• 直接在测试配置中添加version字段，填入你要求的旧版本号：

{
  "name": "Extension Tests",
  "type": "extensionHost",
  "request": "launch",
  "runtimeExecutable": "${execPath}",
  "args": [
    "--extensionDevelopmentPath=${workspaceFolder}",
    "--extensionTestsPath=${workspaceFolder}/out/test/suite/index"
  ],
  "version": "1.70.0" // 替换为你指定的旧版本号
}

• 如果version字段不生效，直接指定对应版本的VSCode可执行文件路径（Windows示例：C:/Program Files/Microsoft VS Code 1.70.0/Code.exe，Mac示例：/Applications/Visual Studio Code 1.70.0.app/Contents/MacOS/Electron），替换默认的${execPath}：

"runtimeExecutable": "C:/Program Files/Microsoft VS Code 1.70.0/Code.exe"

2. 配置vscode-test的测试参数 #

如果项目使用@vscode/test-electron官方测试依赖，需要同步调整测试入口文件的版本指定：

• 先安装兼容目标旧版本的@vscode/test-electron包（可根据目标VSCode版本选择对应测试包版本，比如目标版本1.70.0可搭配@vscode/test-electron@2.2.0）：

npm install @vscode/test-electron@2.2.0 --save-dev

• 修改测试入口文件（通常是test/runTest.ts），在runTests方法中指定版本：

import { runTests } from '@vscode/test-electron';
import * as path from 'path';

async function main() {
  try {
    const extensionDevelopmentPath = path.resolve(__dirname, '../../');
    const extensionTestsPath = path.resolve(__dirname, './suite/index');
    
    await runTests({
      extensionDevelopmentPath,
      extensionTestsPath,
      version: '1.70.0' // 指定目标旧版本
    });
  } catch (err) {
    console.error('测试运行失败');
    process.exit(1);
  }
}

main();

3. 清理本地测试缓存 #

本地缓存的测试版本可能导致干扰，执行以下操作：

• 删除项目根目录下的.vscode-test文件夹（这是测试框架下载VSCode版本的缓存目录）
• 重启VSCode后重新运行测试任务

4. 校验tasks.json配置 #

检查.vscode/tasks.json中的测试任务，确保没有硬编码本地VSCode版本的路径，保持与launch.json的配置逻辑一致，避免任务调用时强制使用本地版本。

内容的提问来源于stack exchange，提问作者dsyx