使用exec async/await与execa.shell时Istanbul无法统计代码覆盖率求助

我之前也踩过这个坑，这本质上是因为 Istanbul（包括它的封装工具 nyc）默认没办法追踪子进程里的代码执行——而 execa.shell 会创建一个全新的子 shell 来运行命令，这就导致覆盖率工具的 instrumentation 代码根本注入不到子进程的执行环境里，自然统计不到后续代码的覆盖率。

下面是几个亲测有效的解决方案：

1. 尽量避免使用 execa.shell，改用直接调用命令的方式 #

execa.shell 虽然写起来方便，但子shell的特性会阻断覆盖率追踪。换成 execa 的基础调用方式（直接传命令和参数数组），就能让覆盖率工具正常追踪代码路径：

const getCode = async ({ cmd, workingDir, stdio }) => {
  try {
    // 注意：如果命令包含带空格的参数，split(' ') 可能会出错，建议手动拆分或用专门的解析库
    const [command, ...args] = cmd.split(' ');
    const commandResponse = await execa(command, args, { cwd: workingDir, stdio });
    return commandResponse.code;
  } catch (e) {
    return e.code;
  }
};

如果你的命令参数比较复杂（比如包含引号、空格），可以用 shell-quote 这类库来安全拆分命令字符串，避免手动拆分的bug。

2. 手动给子进程注入覆盖率钩子（必须用shell模式时） #

如果业务场景必须用 execa.shell，可以通过设置环境变量，让子进程启动时自动加载 Istanbul 的覆盖率工具：

const getCode = async ({ cmd, workingDir, stdio }) => {
  try {
    const commandResponse = await execa.shell(cmd, {
      cwd: workingDir,
      stdio,
      env: {
        ...process.env,
        // 让子进程启动时先加载 Istanbul 的 cover 钩子
        NODE_OPTIONS: `--require ${require.resolve('istanbul/lib/cli.js')} cover`
      }
    });
    return commandResponse.code;
  } catch (e) {
    return e.code;
  }
};

注意：这个方法只对 Node.js 子进程有效，如果你的命令是运行非 Node 程序，覆盖率工具本来就不会统计这类代码，这种情况就不用折腾了。

3. 检查测试用例的异步等待逻辑 #

有时候看起来是覆盖率问题，其实是测试用例没有正确等待子进程执行完成。确保你的测试代码里已经用 await 调用了 getCode 函数，并且没有提前结束测试进程的逻辑。

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