Coverlet 是 .NET Core/.NET 5+ 项目代码覆盖率的事实标准，需引用 Coverlet.Collector 包、测试方法声明为 async Task 并正确 await，确保生成 .pdb 文件且 ReportGenerator 通过 -sourcedirs 显式指定源码路径。
Visual Studio 自带的代码覆盖率在 .NET Core/.NET 5+ 项目里经常漏统计，尤其是 async 方法、多项目引用、自定义 SDK 场景下；Coverlet 是目前最稳的 CLI 方案，不是“可选”，而是“事实标准”。
dotnet test --collect:"XPlat Code Coverage" 为什么没生成 coverage.cobertura.xml？
根本原因不是命令写错，而是测试项目没正确引用 Coverlet.Collector 包（不是 Coverlet.MsBuild，后者已弃用且与 SDK 风格项目不兼容）。
- 检查
.csproj中是否包含：<PackageReference Include="Coverlet.Collector" Version="6.0.0" />（建议用最新稳定版） - 确保测试项目目标框架是
net6.0或更高（netcoreapp3.1也支持，但部分 async 状态机识别不稳定） -
dotnet test必须在测试项目目录下执行，不能在解决方案根目录——否则--collect可能被忽略 - 若使用
--results-directory，需确认路径存在且无中文/空格；覆盖文件默认生成在该目录下的子文件夹中，如./TestResults/xxx/coverage.cobertura.xml
async Task 方法覆盖率显示为“未覆盖”，但测试明明跑了
不是代码没执行，而是覆盖率工具没捕获到状态机里的 MoveNext 分支。关键点在于：测试方法必须是 async Task，且被测方法调用必须用 await，任何 .Result、.Wait()、Task.Run(...).Wait() 都会导致分支丢失。
- 错误写法：
[Fact] public void Test() { _svc.DoAsync().Wait(); }→MoveNext不计入 - 正确写法：
[Fact] public async Task Test() { await _svc.DoAsync(); } - 确保编译输出包含
.pdb文件（<DebugType>portable</DebugType>或embedded），否则 Coverlet 无法映射 IL 到源码行 - 若仍不显示，临时加
<IncludeSource>true</IncludeSource>到.csproj的PropertyGroup中
ReportGenerator 生成的 HTML 报告里，某些类/方法显示 0% 覆盖率
大概率是源码路径没对上——Coverlet 默认按编译时的绝对路径记录文件位置，而 ReportGenerator 解析时若找不到对应 .cs 文件，就只能显示“无源码”，进而归为 0%。
- 运行
reportgenerator时加上-sourcedirs:./src（指向你实际源码根目录），多个路径用分号隔开 - 避免在 CI 中用
$(Build.SourcesDirectory)拼路径时末尾多一个反斜杠，导致路径不匹配 - 检查
coverage.cobertura.xml里<sourcefile>节点的路径是否含盘符（如C:\work\...）；本地开发没问题，但 CI 容器里没有 C: 盘，必须用-sourcedirs显式重映射 - 若用 GitHub Actions，推荐在
reportgenerator命令前加pwd && ls -R src/ | head -20确认路径结构
真正难处理的不是“怎么生成报告”，而是当 coverage.cobertura.xml 里某段逻辑标灰却找不到对应测试时，得翻 IL 查 <Method> 名称是否被编译器重命名（比如 <MyMethod>d__5），再反推它属于哪个 async 方法——这时候别信表面函数名，要看 XML 里的 name 属性和 filename 是否一致。
