要使用 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 能快速将其转为清晰的可视化报告,帮助识别未覆盖的代码路径。
