直接拼接两个 lcov 文件（如 `cat unit.lcov >> e2e.lcov`）在语法上是有效的，但是否可用取决于下游工具（如 sonarqube）是否支持自动去重与跨块合并；推荐使用 `lcov --add` 命令进行语义化聚合，更安全、可控且兼容性更好。
LCOV 是一种基于文本的代码覆盖率数据格式，由若干以 TN:, SF:, DA:, end_of_record 等标记分隔的“记录块”（record blocks）组成，每个块通常对应一个源文件的覆盖率信息。从纯文本结构看，将两个合法 lcov 文件简单拼接（如 cat unit.lcov e2e.lcov > merged.lcov）不会破坏语法合法性——因为 lcov 解析器（如 genhtml 或 lcov --summary）本身能顺序读取并识别多个独立 record blocks，即使同一文件路径（SF:）出现多次，它也会默认合并统计。
然而，关键风险在于下游消费工具的行为差异：
- ✅ lcov 官方工具链（如 lcov --add, genhtml, lcov --summary）原生支持多块同文件合并，会自动累加行覆盖（DA:）、函数覆盖等指标；
- ⚠️ SonarQube（尤其旧版本或通过 Generic Coverage 插件导入时）可能将重复 SF: 视为冲突或仅取首个块，导致 e2e 覆盖率被忽略或统计失真；
- ❌ 某些自研解析器或 CI 插件若未实现 record-level 合并逻辑，可能报错或解析异常。
因此，不推荐依赖 cat 拼接，而应使用 lcov 内置的聚合命令：
# 步骤1：初始化空基础文件（可选，但推荐） lcov --capture --initial --directory . --output-file base.lcov # 步骤2：添加 unit 测试覆盖率 lcov --add-tracefile unit.lcov --output-file merged.lcov # 步骤3：追加 e2e 测试覆盖率（自动合并同名文件） lcov --add-tracefile e2e.lcov --output-file merged.lcov # （可选）清理无效/生成文件路径（提升 Sonar 兼容性） lcov --remove merged.lcov '/node_modules/*' '*/test/*' --output-file final.lcov
该方式优势显著：
? 语义正确：--add-tracefile 显式触发覆盖率合并逻辑，对同一 SF: 下的 DA: 行号计数自动累加（而非覆盖）；
? 可控性强：支持过滤（--remove）、归一化路径（--base-directory）、排除生成文件等预处理；
? 工具友好：输出标准 lcov 格式，被 SonarQube、Codecov、Coveralls 等主流平台广泛验证。
? 注意事项：
- 确保所有输入 lcov 文件中的 SF: 路径在目标环境中可解析（建议统一使用相对路径或通过 --base-directory 标准化）；
- 若 unit 与 e2e 测试运行环境不同（如不同构建目录），先用 lcov --extract 或 --base-directory 对齐源码路径；
- 避免手动编辑 lcov 文件——看似简单，但易引入格式错误（如漏掉 end_of_record、字段顺序错乱），导致解析失败。
总之，cat 拼接是“能跑但不健壮”的捷径；而 lcov --add-tracefile 是符合规范、可复现、易维护的工程化实践。
