VS Code扩展集成测试本地运行正常但在GitHub Actions中失败（涉及Electron/D-Bus连接问题）

我之前也遇到过几乎一模一样的问题——本地VS Code扩展测试跑的顺风顺水，一到GitHub Actions就因为D-Bus连接报错挂掉。本质原因是GitHub Actions的Ubuntu runner是无头环境，没有图形会话支撑Electron（VS Code基于它）的一些默认行为，比如尝试连接D-Bus会话总线。

给你几个亲测有效的解决方案，按优先级尝试：

1. 给测试命令加上虚拟显示支持 #

Electron是GUI应用，无头环境下必须要有虚拟X服务器才能正常启动。最简单的方式是用xvfb-run包裹你的测试命令，直接修改GitHub Actions的workflow文件：

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: pnpm install
      # 关键：用xvfb-run启动测试，自动创建虚拟显示
      - run: xvfb-run --auto-servernum pnpm run test

如果你觉得手动写xvfb-run麻烦，也可以用现成的GitHub Action简化：

- uses: GabrielBB/xvfb-action@v1
  with:
    run: pnpm run test

2. 给VS Code测试添加禁用D-Bus的启动参数 #

如果加了虚拟显示还是报错，那就直接让Electron跳过D-Bus连接尝试。修改你的runTest.js文件，在runTests的launchArgs里加几个参数：

const { runTests } = require('@vscode/test-electron');
const path = require('path');

async function main() {
  try {
    const extensionDevelopmentPath = path.resolve(__dirname, '../../');
    const extensionTestsPath = path.resolve(__dirname, './suite/index');
    
    await runTests({
      extensionDevelopmentPath,
      extensionTestsPath,
      launchArgs: [
        '--no-sandbox',    // 无头环境必备，避免沙箱权限问题
        '--disable-dbus',  // 直接禁用D-Bus连接
        '--disable-gpu',   // 禁用GPU渲染，减少无头环境的依赖
        '--headless'       // 显式指定无头模式
      ]
    });
  } catch (err) {
    console.error('测试运行失败:', err);
    process.exit(1);
  }
}

main();

3. 检查依赖版本兼容性 #

有时候新版本的@vscode/test-electron和GitHub Actions的环境会有兼容性问题。你可以尝试降级到一个稳定的旧版本，比如2.3.0：

pnpm add @vscode/test-electron@2.3.0 --save-dev

4. 显式指定VS Code测试版本 #

自动下载的VS Code版本可能和你本地测试的版本差异过大，导致环境不一致。你可以在runTests里指定一个和本地一致的稳定版本：

await runTests({
  extensionDevelopmentPath,
  extensionTestsPath,
  version: '1.98.0', // 替换成你本地用的VS Code版本
  launchArgs: ['--no-sandbox', '--disable-dbus']
});

如果以上都不行，你还可以在workflow里显式清空D-Bus环境变量试试：

- run: export DBUS_SESSION_BUS_ADDRESS=null && pnpm run test

我当时是用第一种方法（加xvfb-run）就解决了，你可以先从这个入手，应该能快速解决问题。

内容来源于stack exchange