如何在Azure DevOps(ADO)中为逻辑单体仓库实现差异代码覆盖

针对你用Git Submodule构建逻辑单体仓、需要在ADO流水线中实现跨子模块差异代码覆盖的场景，以下是几个可行的落地方案：

方案1：手动生成增量覆盖报告并导入ADO #

利用覆盖率工具针对变更文件生成专属报告，再合并后提交给ADO，让原生覆盖模块识别为差异覆盖数据：

• 步骤1：获取跨子模块的差异文件
  在流水线中遍历所有子模块，分别计算PR源分支与目标分支的差异文件列表：

  git submodule foreach --recursive '
    # 获取子模块追踪的目标分支
    target_branch=$(git config -f .gitmodules submodule.$name.branch)
    # 输出当前子模块的变更文件
    git diff --name-only origin/$target_branch...$(git rev-parse HEAD) > ../diff-$name.txt
  '
  

• 步骤2：生成增量覆盖报告
  • 对于Rust项目：用grcov指定差异文件过滤，生成Cobertura格式报告

    grcov . --binary-path ./target/debug/ -s . -t cobertura --diff ../diff-$name.txt -o ./coverage-$name.xml
    

  • 对于C++项目：用lcov先生成全量报告，再移除非差异文件的覆盖数据

    lcov --capture --directory . --output-file full-coverage.info
    lcov --remove full-coverage.info $(cat ../diff-$name.txt | awk '{print "^"$0}') --output-file delta-coverage-$name.info
    genhtml delta-coverage-$name.info --output-directory coverage-report-$name
    

• 步骤3：合并报告并上传
  用cobertura-merge等工具将所有子模块的增量报告合并为一份总报告，再通过ADO的PublishCodeCoverageResults任务提交，同时开启diffCoverageEnabled: true参数。

方案2：通过脚本扩展ADO流水线的差异覆盖逻辑 #

直接在流水线中动态计算差异范围，让覆盖率工具仅针对变更代码统计覆盖，再将结果注入ADO的覆盖体系：

• 在PR触发的流水线中，先获取PR的源/目标分支信息，然后遍历子模块执行覆盖统计：

  - script: |
      git submodule update --init --recursive
      # 遍历子模块
      git submodule foreach --recursive '
        target_branch=$(git config -f .gitmodules submodule.$name.branch)
        diff_files=$(git diff --name-only origin/$target_branch...HEAD)
        # Rust项目示例：仅统计差异文件的覆盖
        RUSTFLAGS="-C instrument-coverage" cargo test
        grcov . --binary-path ./target/debug/ -s . -t cobertura --diff "$diff_files" -o ../../coverage-$name.xml
      '
      # 合并所有子模块报告
      cobertura-merge -o combined-coverage.xml $(find . -name "coverage-*.xml")
    displayName: 'Generate delta coverage reports'
  
  - task: PublishCodeCoverageResults@1
    inputs:
      codeCoverageTool: 'Cobertura'
      summaryFileLocation: '$(System.DefaultWorkingDirectory)/combined-coverage.xml'
      diffCoverageEnabled: true
  

方案3：自定义PR评论展示差异覆盖数据 #

如果ADO原生差异覆盖模块无法识别跨子模块数据，可以自行计算并通过PR评论展示结果：

• 用脚本统计每个子模块差异代码的覆盖行数、未覆盖行数，计算覆盖率百分比：

  # 示例：统计Rust子模块差异覆盖情况
  diff_lines=$(git diff --stat origin/$target_branch...HEAD | awk '{print $4}')
  covered_lines=$(grcov . --binary-path ./target/debug/ -s . -t text --diff "$diff_files" | grep -E "^.*:.*covered" | awk '{print $4}')
  delta_coverage=$((covered_lines * 100 / diff_lines))
  

• 通过ADO的InvokeRestApi任务调用PR评论API，将计算结果以Markdown格式评论到PR中，比如：

  ### 子模块XX差异覆盖报告
  - 变更代码行数：XXX
  - 已覆盖行数：XXX
  - 差异覆盖率：XX%
  

关键注意事项 #

• 确保流水线正确初始化子模块：在Checkout任务中开启submoduleCheckout: true，或手动执行git submodule update --init --recursive
• 统一文件路径：子模块的文件在主仓中有前缀路径，生成报告时要保留相对路径，避免ADO无法匹配代码文件
• 适配语言特性：C++编译需添加-fprofile-arcs -ftest-coverage参数，Rust需启用instrument-coverage编译选项

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