用reportgenerator将coverage.json转html报告：先装dotnet-reportgenerator-globaltool，再运行reportgenerator "-reports:路径" "-targetdir:输出目录"，注意路径无空格、文件存在且用绝对路径，浏览器需通过http服务打开html。
dotnet test 生成的 coverage.json 怎么导出为 HTML 报告
默认 dotnet test 不生成可视化报告，只输出覆盖率数据（如 coverage.json），需要额外工具转换。核心是用 coverlet.collector + reportgenerator 组合：前者负责采集，后者负责渲染。
常见错误是只装了 coverlet.msbuild 或漏配 --collect:"XPlat Code Coverage"，导致根本没生成 coverage.json。
- 测试项目需引用
coverlet.collector（NuGet 包，v6.0+ 推荐） - 运行命令必须带
--collect:"XPlat Code Coverage"，例如：dotnet test --collect:"XPlat Code Coverage" --results-directory ./test-results
- 生成的
coverage.json默认在./test-results/coverage/下，不是根目录 - 若用
ReportGeneratorCLI，需全局安装：dotnet tool install -g dotnet-reportgenerator-globaltool
多个 test project 的 coverage.json 如何合并
每个 dotnet test 调用会生成独立的 coverage.json，直接丢给 reportgenerator 就能自动合并——它支持多输入路径，无需手动拼接 JSON。
容易踩的坑是路径写错或遗漏文件名通配符，导致只读到一个文件。
- 确保所有
coverage.json路径都明确指定，例如：reportgenerator "-reports:./proj1/test-results/coverage/coverage.json;./proj2/test-results/coverage/coverage.json" "-targetdir:./coverage-report"
- 路径中不能有空格，否则需用引号包裹整个
-reports:参数值 - 如果某个项目没跑测试，对应路径下没有
coverage.json，reportgenerator会报错退出，建议先ls或dir确认存在 - 合并时不会去重 assembly，同名 DLL 多次出现会导致统计偏差（但实际影响小，因 coverlet 按 module + method 唯一标识）
reportgenerator 输出的 HTML 报告打不开或空白
最常见原因是浏览器安全策略阻止本地 file:// 协议加载 JS 资源（比如 index.html 双击打开），不是代码问题。
另一个原因是 reportgenerator 版本太低（
- 用
http-server或python3 -m http.server启个本地服务访问，避免file://限制 - 检查
reportgenerator版本：reportgenerator -version，推荐 v5.1.10+ 或 v5.3+（对 .NET 7/8 支持更稳） - 生成后检查
./coverage-report/index.html是否真实存在，且大小 >1KB；若只有几百字节，大概率是 schema 不匹配 - 加
-reporttypes:HtmlInline_AzurePipelines_Dark可减少外部依赖，适合 CI 场景
CI 环境里如何稳定生成并上传 coverage 报告
CI（如 GitHub Actions、Azure Pipelines）里路径不稳定、权限受限、无 GUI，导致本地能跑的命令失败。
关键不是“怎么生成”，而是“怎么让生成步骤不被环境干扰”。比如 Windows CI 默认禁用 long path，可能卡在写入深层目录。
- 统一用绝对路径，避免
./相对路径歧义；GitHub Actions 中可用${{ github.workspace }} - 显式设置
COVERLET_DISABLE_APPDOMAIN=1环境变量，防止 .NET Framework 兼容层干扰 - 加
--settings coverlet.runsettings文件控制 include/exclude，避免第三方 DLL 拉低覆盖率（如<include>**/MyApp.*.dll</include>） - 上传前压缩
coverage-report/目录，比传单个 HTML 更可靠（有些 CI 插件只认 zip）
真正麻烦的不是合并或生成，是不同 SDK 版本下 coverlet.collector 对 System.Private.CoreLib 的覆盖行为不一致——有时候跳过，有时候报错，得靠 [ExcludeFromCodeCoverage] 手动绕过。
