coverlet 是一个 .NET 覆盖率收集工具，本身不生成 HTML 报告，仅输出 JSON 或 Cobertura XML 格式数据；需配合 reportgenerator 等工具转换为 HTML。
coverlet 是什么，它能直接生成 HTML 报告吗
coverlet 本身不生成 HTML 报告，它只负责在测试运行时收集覆盖率数据（输出 .json 或 .cobertura.xml 格式），后续需配合 reportgenerator 等工具转换为可视化报告。直接执行 dotnet test 加 coverlet 参数，若没配输出格式或没接下游工具，你会看到控制台里只有“0%”“12%”这类数字，但没有文件生成。
如何用 coverlet + reportgenerator 生成 HTML 报告
分两步：先用 coverlet 收集数据，再用 reportgenerator 渲染。推荐用 dotnet tool 方式安装，避免全局环境污染：
- 安装
reportgenerator：dotnet tool install -g dotnet-reportgenerator-globaltool - 在测试项目目录下运行：
dotnet test /p:CollectCoverage=true /p:CoverletOutputFormat=opencover /p:CoverletOutput=./coverage/ - 生成 HTML：
reportgenerator "-reports:./coverage/coverage.opencover.xml" "-targetdir:./coverage/report" "-reporttypes:Html"
注意：CoverletOutputFormat=opencover 是 reportgenerator 兼容性最好的格式；CoverletOutput 路径末尾要带斜杠，否则可能写入失败；生成的报告入口是 ./coverage/report/index.html。
常见报错和绕过方法
覆盖率达不到预期？多半是以下原因：
本文档主要讲述的是maven使用方法；Maven是基于项目对象模型的（pom），可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。Maven将你的注意力从昨夜基层转移到项目管理层。Maven项目已经能够知道 如何构建和捆绑代码，运行测试，生成文档并宿主项目网页。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
-
System.ArgumentException: Unable to find project root：说明 coverlet 找不到 .csproj，确保在含测试项目的目录下执行dotnet test，不要在解决方案根目录盲目运行 - 覆盖率显示为 0%，但测试明明通过：检查是否用了
[ExcludeFromCodeCoverage]特性，或是否测试项目引用了被测项目但未启用InternalsVisibleTo（内部类/方法无法被覆盖） - HTML 报告里路径乱码或缺失源码：reportgenerator 默认不嵌入源码，加参数
-sourcedirs:../src/MyProject显式指定源码路径（注意是相对路径，且需指向实际.cs文件所在目录）
CI 环境中怎么稳定跑覆盖率
GitHub Actions 或 Azure Pipelines 里容易因路径、权限或并行测试导致覆盖率中断：
- 禁用并行测试：
dotnet test --no-build /p:CollectCoverage=true /p:CoverletOutputFormat=cobertura /p:CoverletOutput=./coverage/ /p:DisableParallelization=true - 确保
coverlet.msbuild包版本与 SDK 兼容（.NET 6+ 推荐用coverlet.collector，而非旧版coverlet.msbuild） - Linux CI 上注意大小写敏感：
CoverletOutput路径里的大小写必须与实际目录一致，否则reportgenerator找不到输入文件
最常被忽略的是：coverlet 默认不覆盖 async void 方法、构造函数初始化表达式（C# 12 的 primary constructors）、以及 global using 引入的命名空间——这些地方即使有逻辑，也不会计入覆盖率统计。
