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。
常见报错和绕过方法
覆盖率达不到预期？多半是以下原因：
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引入的命名空间——这些地方即使有逻辑，也不会计入覆盖率统计。
