VS Code扩展运行时调试问题：如何在扩展中调试基于js-mocha封装的自定义测试框架

嗨，我之前也碰到过类似的场景，要在VS Code扩展里调试封装了Mocha的自定义测试框架，确实绕了点弯路。process._debugProcess(PID)没用很正常——这个是Node.js的底层方法，VS Code的调试系统是基于Debug Adapter Protocol（DAP）的，直接调用它没法触发VS Code的调试会话，而且扩展宿主环境可能还有沙箱限制，所以这条路走不通。

给你几个亲测有效的方案，按优先级推荐：

方案一：Spawn带调试参数的子进程 + 自动Attach调试 #

这是最直接的方式，核心思路是把测试框架CLI作为独立子进程启动，带上Node.js调试参数，再让VS Code自动附加到这个进程上。

具体步骤： #

1. 启动带调试参数的测试进程
   用child_process.spawn启动测试框架CLI时，加上--inspect-brk参数（--inspect是启动后直接运行，--inspect-brk会在入口处暂停，方便你加断点）：

const { spawn } = require('child_process');
const path = require('path');
const vscode = require('vscode');

// 选一个空闲端口，也可以用portfinder包自动找
const debugPort = 9229;

// 启动测试框架CLI
const testProcess = spawn('node', [
  `--inspect-brk=${debugPort}`,
  // 你的测试框架CLI的路径
  path.resolve(__dirname, '../your-test-framework/bin/cli.js'),
  // 测试框架需要的参数，比如测试文件路径、配置路径等
  './tests/my-test.spec.js',
  '--config', './test-config.json'
]);

// 监听进程输出，方便排查问题
testProcess.stdout.on('data', (data) => {
  console.log(`测试进程输出: ${data}`);
});

testProcess.stderr.on('data', (data) => {
  console.error(`测试进程错误: ${data}`);
});

2. 让VS Code自动附加到该进程
   用VS Code的vscode.debug.startDebugging方法，创建一个Node.js Attach的调试配置，自动触发调试：

async function attachDebugger(port) {
  const debugConfig = {
    type: 'node',
    request: 'attach',
    name: '调试自定义测试框架',
    port: port,
    skipFiles: ['<node_internals>/**'], // 跳过Node内部代码，聚焦你的框架
    // 如果你的框架用了TypeScript，记得配置sourceMaps
    sourceMaps: true,
    outFiles: ['${workspaceFolder}/your-test-framework/dist/**/*.js']
  };

  const workspaceFolder = vscode.workspace.workspaceFolders?.[0];
  if (!workspaceFolder) {
    vscode.window.showErrorMessage('请打开工作区文件夹');
    return;
  }

  // 启动调试会话
  await vscode.debug.startDebugging(workspaceFolder, debugConfig);
}

// 在启动进程后调用
attachDebugger(debugPort);

方案二：配置复合调试会话（同时调试扩展和测试框架） #

如果需要同时调试扩展本身的代码和测试框架，推荐在扩展的.vscode/launch.json里配置复合调试：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "调试扩展",
      "type": "extensionHost",
      "request": "launch",
      "runtimeExecutable": "${execPath}",
      "args": ["--extensionDevelopmentPath=${workspaceFolder}"],
      "outFiles": ["${workspaceFolder}/out/**/*.js"]
    },
    {
      "name": "附加到测试框架",
      "type": "node",
      "request": "attach",
      "port": 9229,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/../your-test-framework/dist/**/*.js"]
    }
  ],
  "compounds": [
    {
      "name": "扩展+测试框架调试",
      "configurations": ["调试扩展", "附加到测试框架"]
    }
  ]
}

启动这个复合配置后，VS Code会同时启动扩展的调试会话和测试框架的Attach会话，你可以在两边加断点调试。

注意事项 #

• 端口冲突：固定端口可能被占用，建议用portfinder包自动获取空闲端口，避免手动指定的麻烦。
• 源码映射：如果你的测试框架是用TypeScript写的，一定要确保sourceMaps配置正确，否则断点会打在编译后的JS文件上，找不到对应的TS源码。
• CLI启动方式：如果你的测试框架CLI是用shebang（#!/usr/bin/env node）开头的脚本，不要直接spawn脚本，一定要用node命令启动，否则调试参数不会生效。

这个思路应该能解决你的问题，我之前就是这么搞定的，调试起来和直接调试Mocha脚本一样顺畅。

备注：内容来源于stack exchange，提问作者TheRealNight