OpenCV的FileStorage XML是带特定schema的非标准格式，以为根，含type_id、dt编码和空格分隔data；必须用OpenCV FileStorage读取，不可手动解析。
FileStorage XML 文件结构长什么样？
OpenCV 的 FileStorage 生成的 XML 不是标准 DOM XML，而是带 OpenCV 特定 schema 的序列化格式，例如：
<opencv_storage><my_matrix type_id="opencv-matrix"><rows>2</rows><cols>3</cols><dt>f</dt> <data>1.0 2.0 3.0 4.0 5.0 6.0</data></my_matrix></opencv_storage>
注意 type_id、dt（数据类型编码）、data 内容空格分隔——这些不是通用 XML 规则，而是 OpenCV 自己约定的。直接用 tinyxml2 或 pugixml 解析后还得手动映射类型和维度，容易出错。
为什么不能直接用 std::ifstream + 字符串解析？
因为 FileStorage 的 XML 是“扁平化”序列化：矩阵、向量、嵌套 FileNode 都可能混在同级节点下，且 data 块里数值不换行、无类型标记。比如：dt 值为 f 表示 float，i 表示 int，3f 表示 Vec3f——这些必须查 OpenCV 源码或文档才能对应。手写解析器极易漏掉 type_id="opencv-nd-array" 这类变体，或把 <size></size> 当普通字段处理。
最稳的解法：复用 OpenCV 自己的 FileStorage 读取
别绕开 OpenCV，它已提供完整反序列化能力。关键点是：用 FileStorage 以 READ 模式打开 XML，再用 operator[] 和 node() 导航，最后用 read() 或模板重载提取值：
- 确保 XML 文件路径正确，且编码为 UTF-8（Windows 下若用记事本保存过，可能含 BOM，导致
isOpened()返回 false） - 读取矩阵时，优先用
node["my_matrix"] >> mat，而非先node["my_matrix"].read(mat)——前者会自动处理type_id和dt - 读取标量需明确类型，例如
double val; node["thresh"] >> val;；若存的是 int 但读 double，OpenCV 会隐式转换，但精度可能丢失 - 嵌套结构如
<roi><x>10</x><y>20</y></roi>，用FileNode roi = node["roi"];后再取roi["x"]，不要试图用 XPath
常见报错与绕过技巧
FileStorage::isOpened() == false：多数因文件路径含中文或空格未加引号（Linux/macOS 下 shell 展开问题），或权限不足；建议用绝对路径 + std::filesystem::exists() 预检。
cv::Exception at ... what(): OpenCV(4.8.0) ... error: (-215:Assertion failed) !_reader.empty() in function 'read'：说明节点不存在或名字拼错，检查 node.empty() 再操作，例如：
cv::FileNode n = fs["missing_key"]; if (!n.empty()) n >> value;
读取 std::vector<:point2f></:point2f> 失败：XML 中必须是 <points>1.0 2.0 3.0 4.0</points> 形式（偶数个 float），且节点名要匹配；OpenCV 不支持 <point><x>1</x><y>2</y></point> 这种结构化写法。
真正麻烦的不是语法，而是 OpenCV 对 XML 的“半封闭”设计：它不公开 dt 到 C++ 类型的完整映射表，也不保证跨版本兼容。如果必须脱离 OpenCV 解析（比如嵌入式无 OpenCV 环境），得硬啃 modules/core/src/persistence_xml.cpp 里的 readScalar 和 readMat 实现逻辑——这事真干过的人，基本都回去了。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
