如何让Azure DevOps同时实现PR代码覆盖率差异展示与门禁管控？

核心思路 #

通过一次测试任务统一收集XPlat Code Coverage数据（生成标准Cobertura格式报告），既满足ReportGenerator生成PR差异HTML报告的需求，又能让Azure DevOps（ADO）基于该报告计算新代码覆盖率，实现PR门禁管控，彻底解决两种场景的冲突问题。

步骤1：修改测试任务，统一收集XPlat覆盖率 #

替换原测试任务中--collect "Code coverage"为XPlat Code Coverage，并指定结果目录方便后续定位文件：

- task: DotNetCoreCLI@2  
  displayName: 'Unit Test .sln'
  inputs:
    command: 'test'
    workingDirectory: '$(Build.SourcesDirectory)\src\'
    arguments: '--configuration debug --logger trx --collect "XPlat Code Coverage" --results-directory $(Agent.TempDirectory)/test-results --no-build'
    publishTestResults: false

步骤2：简化覆盖率处理流程，生成差异HTML报告 #

XPlat直接生成Cobertura格式报告，无需再转换.coverage文件。保留工具安装任务，修改报告生成步骤开启差异计算：

- task: DotNetCoreCLI@2
  displayName: "Install Report Generator"
  inputs:
    command: "custom"
    custom: "tool"
    arguments: 'install --global dotnet-reportgenerator-globaltool'    

- task: CmdLine@2
  displayName: 'Generate coverage report with diff'
  condition: succeededOrFailed()
  inputs: 
    script: |
      reportgenerator "-reports:$(Agent.TempDirectory)/test-results/**/coverage.cobertura.xml" \
      "-targetdir:$(Agent.TempDirectory)/coverage" \
      "-reporttypes:HtmlInline_AzurePipelines;Cobertura" \
      "-tag:$(CDP_FILE_VERSION_SEMANTIC)" \
      "-assemblyfilters:-*tests*;-*moq*" \
      "-historydir:$(Agent.TempDirectory)/coverage-history" \
      "-verbosity:Verbose"

• -historydir：存储历史覆盖率数据，ReportGenerator会自动对比PR目标分支的覆盖率，生成差异报告
• -assemblyfilters：排除测试项目和第三方依赖，避免无效数据干扰

步骤3：发布覆盖率结果，供ADO识别 #

发布Cobertura报告，让ADO能读取并计算新代码覆盖率：

- task: PublishCodeCoverageResults@1
  displayName: 'Publish coverage results'
  condition: succeededOrFailed()
  inputs:
    codeCoverageTool: 'Cobertura'
    summaryFileLocation: '$(Agent.TempDirectory)/test-results/**/coverage.cobertura.xml'
    pathToSources: '$(Build.SourcesDirectory)'
    reportDirectory: '$(Agent.TempDirectory)/coverage'

步骤4：配置PR门禁规则 #

1. 进入项目设置 → 存储库 → 目标存储库 → 分支策略
2. 找到PR目标分支（如main），点击「添加状态检查」，选择「代码覆盖率」
3. 规则配置选择新代码，设置阈值（如75%），勾选「需要通过才能完成拉取请求」
4. 确认构建任务发布的覆盖率结果被ADO识别，此时门禁将基于PR新增/修改的代码计算覆盖率，而非整体DLL覆盖率

关键注意事项 #

• 移除原dotnet-coverage merge步骤，XPlat生成的Cobertura报告无需二次转换
• 建议用ADO缓存任务缓存$(Agent.TempDirectory)/coverage-history目录，避免每次重新拉取历史数据，提升效率
• 若仍有门禁误报，检查-assemblyfilters是否正确排除了非业务代码，确保覆盖率计算范围准确

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