coverlet 本身不生成 html 报告,仅输出 coverage.json 等原始数据;需配合 reportgenerator 转换:先 dotnet test --collect:"xplat code coverage" 生成数据,再用 reportgenerator 渲染为 html。

Coverlet 本身不提供可视化报告,必须配合 dotnet test 和报告生成器(如 reportgenerator)才能看到 HTML 覆盖率页面;直接运行 dotnet test --collect:"XPlat Code Coverage" 只会生成 .coverage 二进制文件,无法直接阅读。
如何正确安装 Coverlet 并启用覆盖率收集
Coverlet 是以 NuGet 包形式集成到测试项目的,不是全局工具。常见错误是试图用 dotnet tool install 安装它,结果测试时完全没触发收集。
- 在你的 xUnit/NUnit 测试项目(.csproj)中添加:
<packagereference include="coverlet.msbuild" version="6.0.2"></packagereference>
(推荐coverlet.msbuild,兼容性好;coverlet.collector需额外指定--collect参数) - 确保目标框架一致:被测项目和测试项目都使用
net8.0或net6.0,混用netstandard2.0会导致覆盖率为空 - 禁用增量编译干扰:临时加上
/p:UseSharedCompilation=false,避免因后台编译缓存导致部分方法未被 instrument
为什么 dotnet test 没输出覆盖率数据?检查这三点
90% 的“没数据”问题出在配置或路径上,而不是 Coverlet 本身坏了。
ApiPost是一个支持团队协作,支持模拟POST、GET、PUT等常见请求,并可直接生成文档的API调试、管理工具,ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具,ApiPost官方版界面美观大方,功能强劲实用,支持团队协作,支持模拟POST、GET、PUT等常见请求,是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键
-
dotnet test必须在测试项目目录下执行(即包含.csproj的目录),不能在解决方案根目录下跑——否则coverlet.msbuild找不到要插桩的程序集 - 被测项目必须被测试项目显式引用(
ProjectReference),不能只靠 NuGet 引用 DLL;Coverlet 只能 instrument 源码编译出的程序集 - 确认没有设置
<istestproject>false</istestproject>或误删了<targetframework></targetframework>,否则 MSBuild 不会加载 coverlet 的 targets
生成可读的 HTML 报告:reportgenerator 是刚需
Coverlet 输出的是 OpenCover 格式(coverage.json),浏览器打不开。必须用 reportgenerator 翻译成 HTML。
- 全局安装:
dotnet tool install -g dotnet-reportgenerator-globaltool - 测试后生成报告:
dotnet test --collect:"XPlat Code Coverage" --settings coverlet.runsettings<br>reportgenerator "-reports:TestResults/**/coverage.json" "-targetdir:CoverageReport" "-reporttypes:Html"
-
coverlet.runsettings文件需包含:<runsettings><br><datacollectionrunsettings><br><datacollectors><br><datacollector friendlyname="XPlat Code Coverage"><br><configuration><br><format>opencover</format><br></configuration><br></datacollector><br></datacollectors><br></datacollectionrunsettings><br></runsettings>
最容易被忽略的是:Coverlet 默认跳过 async void 方法、#if DEBUG 块内代码、以及所有 get;set; 自动属性的 backing field —— 这些不会报错,但也不会计入覆盖率,别误以为是工具漏了。










