JavaScript单元测试中合并多文件覆盖率结果，关键是由工具自动聚合而非手动拼接：Jest默认自动合并所有匹配测试文件的覆盖率；Vitest需配置统一cacheDir或选用c8；分步测试时须用lcov --add-tracefile语义合并并统一路径。

JavaScript 单元测试中合并多个测试文件的覆盖率结果，关键不是“手动拼接”，而是让测试工具在运行阶段自动识别并聚合所有被测源码的执行痕迹。只要配置得当，Jest、Vitest 或 nyc 都能天然支持多文件覆盖率合并——你不需要写脚本去逐个读取 .lcov 再叠加。

Jest 默认就自动合并所有测试文件的覆盖率

Jest 内置 Istanbul 覆盖率收集器，只要所有测试文件被 testMatch 或 testRegex 匹配到，运行时就会统一采集、跨文件合并。无需额外操作：

• 确保 collectCoverage: true
• 指定 coverageDirectory: 'coverage'
• 设置 coverageReporters: ['html', 'lcov', 'text-summary']
• 推荐用 coverageProvider: 'v8'（更快、更准，但注意不支持装饰器映射）

Jest 并行执行（默认开启）时，各 worker 会把临时覆盖率数据写入内存或临时目录，最终由主进程汇总生成一份总报告。

Vitest 需明确指定覆盖率提供者和缓存路径

Vitest 不像 Jest 那样开箱即合，尤其在多线程或跨环境测试时，容易因缓存隔离导致覆盖率分散：

• 若用 istanbul（需安装 vite-plugin-istanbul），在 vitest.config.ts 中配置：

  • coverage.provider: 'istanbul'
  • coverage.enabled: true
  • coverage.reporter: ['lcov', 'text']
  • coverage.cacheDir: './node_modules/.vitest/coverage'（确保所有测试共享同一缓存）

• 若用 c8（V8 原生）：

  

  Json Repair Kit

  使用 Node.js 评估修复格式错误的 JSON，自动纠正尾随逗号、单引号、未加引号的键等常见问题，实现文件规范化。

  下载
  • coverage.provider: 'c8'
  • 它默认使用 V8 的 --experimental-source-map-support，路径对齐更稳定，适合 TypeScript 项目

多入口或分步测试时，用 lcov 工具手动合并

当你不得不分开运行（比如 test:unit 和 test:e2e），且各自生成了 unit.lcov 和 e2e.lcov，那就用 lcov 命令语义化合并：

• 安装：npm install -g lcov 或直接 npx lcov
• 合并命令：

  lcov --add-tracefile unit.lcov \
       --add-tracefile e2e.lcov \
       --output-file coverage/merged.lcov

• 清理无关路径（提升 Sonar 兼容性）：

  lcov --remove coverage/merged.lcov 'node_modules/*' '**/*.test.*' --output-file coverage/final.lcov

⚠️ 别用 cat unit.lcov e2e.lcov > merged.lcov —— 这只是文本堆叠，SonarQube 等平台可能只读第一个同名 SF: 块，造成覆盖率低估。

小心路径不一致导致“同一文件被当成两个”

合并失败最常见的原因是源码路径不统一。例如：

• unit.lcov 里是 SF:/Users/xxx/project/src/utils.js
• e2e.lcov 里是 SF:../src/utils.js

这时 lcov --add-tracefile 无法识别为同一文件。解决办法：

• 运行测试前统一设置 --base-directory ./src（对 lcov 命令）
• 或在 Jest/Vitest 中配置 coverageDirectory 和 rootDir，确保生成的 lcov.info 使用相对路径
• TypeScript 项目还要检查 sourceMap: true 和 outDir 是否干扰路径映射

不复杂但容易忽略