使用--changedSince时如何避免Jest统计被引用的未变更文件覆盖率

问题根源 #

Jest 执行带 --coverage 和 --changedSince 参数的命令时，只会运行和变更文件相关的测试用例，同时默认会收集所有本次测试运行时加载到的文件的覆盖率数据。被修改文件对应测试引用的未修改源文件，会因为被测试加载而被纳入覆盖率统计，但由于对应的测试文件本身未变更不会被运行，最终只会统计到部分覆盖数据。

解决方法 #

方案1：命令行显式指定覆盖率收集范围 #

结合 git diff 动态获取变更的源文件列表，通过 --collectCoverageFrom 参数限制仅收集这些文件的覆盖率，示例命令如下（适配类Unix系统）：

jest --coverage --changedSince=main --collectCoverageFrom=$(git diff --name-only main -- '*.ts' '*.tsx' | grep -v '.test.' | xargs | sed 's/ /,/g')

命令说明：

• 把 main 替换为你需要对比的基准分支名，比如 master、develop
• git diff --name-only main 会获取所有和基准分支相比变更的文件
• grep -v '.test.' 过滤掉测试文件，只保留源文件
• 最后通过字符串替换把文件列表转为逗号分隔的格式传给 --collectCoverageFrom

方案2：封装为npm脚本方便调用 #

把上述命令写入项目 package.json 的 scripts 字段中，后续直接运行对应脚本即可：

{
  "scripts": {
    "test:coverage:changed": "jest --coverage --changedSince=main --collectCoverageFrom=$(git diff --name-only main -- '*.ts' '*.tsx' | grep -v '.test.' | xargs | sed 's/ /,/g')"
  }
}

如果是Windows环境，可以编写简单的Node.js脚本获取变更文件列表，再调用Jest传入对应参数即可。

方案3：结合Jest配置文件固定规则 #

如果你的项目源文件都放在固定目录（比如src/），也可以在jest.config.js中配置collectCoverageFrom规则，同时配合--changedSince使用：

// jest.config.js
module.exports = {
  // 其他配置...
  collectCoverageFrom: [
    "src/**/*.{ts,tsx}",
    "!src/**/*.test.{ts,tsx}",
    "!src/**/*.d.ts"
  ],
  // 开启该配置后，Jest会自动关联覆盖率收集和变更文件范围，不会追溯引用依赖
  changedFilesWithAncestor: false
}

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