如何使用 ReportGenerator 生成 .NET 测试报告?

来源:这里教程网 时间:2026-02-21 17:27:59 作者:

要使用 ReportGenerator 生成 .NET 测试报告,核心步骤是:先运行测试并生成覆盖率数据(如 .coverage 或 cobertura 格式),然后通过 ReportAnalyzer 将其转换为人类可读的 HTML 报告。整个过程不依赖 IDE,适合集成到 CI/CD 流程中。

安装 ReportGenerator

ReportGenerator 是一个开源工具,支持多种输入格式。可以通过 .NET CLI 全局安装:

dotnet tool install -g dotnet-reportgenerator-globaltool

如果已安装,可使用以下命令更新:

dotnet tool update -g dotnet-reportgenerator-globaltool

生成测试覆盖率数据

在使用 ReportGenerator 前,需要先运行测试并输出覆盖率文件。推荐使用 coverlet 配合 dotnet test

dotnet test --collect:"XPlat Code Coverage" --settings coverlet.runsettings

这会生成一个 coverage.cobertura.xml 文件(路径通常在 TestResults 目录下)。确保项目中已引用 coverlet.collector 和 coverlet.msbuild 包:

使用 ReportGenerator 生成 HTML 报告

假设覆盖率文件为 coverage.cobertura.xml,执行以下命令生成报告:

reportgenerator -reports:./TestResults/**/coverage.cobertura.xml -targetdir:./CoverageReport -reporttypes:HTMLInline

关键参数说明:

-reports:指定输入的覆盖率文件路径,支持通配符 -targetdir:输出报告的目录 -reporttypes:报告格式,常用 HTMLInline 可直接在浏览器打开查看

执行后打开 ./CoverageReport/index.html 即可查看详细覆盖情况,包括每行代码是否被执行。

集成到构建流程

可在 CI 脚本(如 GitHub Actions、Azure DevOps)中自动执行上述步骤:

dotnet test --collect:"XPlat Code Coverage" reportgenerator -reports:./TestResults/**/coverage.cobertura.xml -targetdir:./CoverageReport -reporttypes:HTMLInline

完成后可将 CoverageReport 目录作为构建产物上传,便于团队查阅。

基本上就这些。只要 coverage 数据生成正确,ReportGenerator 能快速将其转为清晰的可视化报告,帮助识别未覆盖的代码路径。

相关推荐