Clover XML解析失败因默认命名空间未显式声明，需用XNamespace(ns)拼接元素名；提取指标应定位//metrics并空值检查；HTML报告需用CDN加载Chart.js或内联数据。
为什么直接读取 Clover XML 会解析失败
Clover 生成的 XML 默认带命名空间（http://schemas.atlassian.com/clover/2.0），但 C# 的 XDocument.Load 或 XmlDocument.Load 不会自动处理前缀绑定，导致 Descendants("coverage") 之类查询返回空。这不是文件损坏，也不是路径错，是命名空间没显式声明就查不到节点。
- 必须用
XNamespace显式声明前缀，再拼接元素名，例如：ns + "project" - 常见错误现象：
doc.Root?.Element(ns + "project")返回 null，但用文本编辑器打开 XML 确实有 - Clover 3.x 和 4.x 的 XML 结构基本一致，但 4.x 可能多出
metrics嵌套层级，建议统一用//metrics轴定位
用 LINQ to XML 提取关键覆盖率指标
别碰 DTD 或 XSD 验证——Clover XML 通常不带内联 DTD，强行设置 XmlReaderSettings.DtdProcessing = DtdProcessing.Parse 会抛 XmlException。直接按结构提取 statements、coveredstatements 更稳。
- 核心路径是：
root.Element(ns + "project")?.Element(ns + "metrics") - 语句覆盖率 =
(int)metrics?.Attribute("coveredstatements") / (double)(int)metrics?.Attribute("statements")，注意空值检查和整除陷阱 - 函数名、类名藏在
file节点的name属性里，不是文本内容；方法级数据在file/methods/method下，需遍历metrics子节点
生成简易 HTML 报告时绕开浏览器安全限制
本地双击打开 HTML 文件时，Chrome/Firefox 会因 file:// 协议禁止加载本地 JS（如 Chart.js），导致图表空白。这不是代码错，是浏览器策略。
- 不要写
<script src="./chart.min.js"></script>，改用 CDN：<script src="https://cdn.jsdelivr.net/npm/chart.js"></script> - 避免用
fetch("./clover.xml")加载本地 XML——XML 文件得走 HTTP 服务才能跨域读取；要么用 C# 后端吐 HTML+内联数据，要么把覆盖率数据序列化进 HTML 的<script>var coverageData = {...}</script> - 如果坚持纯静态，用 Python 快速起个 HTTP 服务：
python3 -m http.server 8000，然后访问http://localhost:8000/report.html
可视化时 class-level 和 file-level 数据容易混淆
Clover XML 中 metrics）和内部所有 metrics。直接取 file/metrics 当作类覆盖率，会把同文件多个类的数据混成一个值。
- 要获取单个类的覆盖率，必须进到
file/classes/class/metrics，而不是复用外层file/metrics -
file的name属性是相对路径（如src/Utils.cs），而class的name是全限定名（如MyApp.Utils），二者不可互换用于映射 - 若需按命名空间分组统计，得从
class/name拆解，不能依赖file/name的目录结构
真正麻烦的是 method 级覆盖数据：Clover 不保证每个 method 都有 metrics 节点（未执行的方法可能缺失），查的时候得用 element?.Element(ns + "metrics") != null 判空，不能只看 method 元素是否存在。
