手写tinyxml2序列化最可控，需严格按Schema处理字段名映射、空值跳过、命名空间声明、布尔/时间格式化及XSD验证；const成员函数确保线程安全。
用 tinyxml2 手动序列化类成员到 XML，不依赖代码生成
直接手写序列化逻辑是最可控的方式，尤其当 Schema 约束较松、字段少且变动频繁时。tinyxml2 轻量、头文件即用、无运行时依赖，适合嵌入式或跨平台场景。tinyxml2::XMLDocument 和 XMLNode 是核心操作对象。
常见错误是把类字段名硬编码为 XML 标签名，结果 Schema 要求 user_id 而类里叫 m_userId，导致校验失败；或者忽略空值处理——Schema 定义某字段 minOccurs="0"，但代码仍强行写入空标签，触发下游解析异常。
- 先按 Schema 明确每个字段的 XML 元素名、是否可选、是否需属性（如
<name lang="zh">） - 对数值类型用
SetText()前必须转字符串（std::to_string()），不能传整数指针 - 布尔值统一转
"true"/"false"（小写），避免用1/0——多数 Schema 工具只认字面量布尔 - 时间字段若 Schema 要求 ISO 8601（如
2024-05-20T14:30:00Z），别用ctime()直接拼接，要用std::put_time或第三方库格式化
处理 XML 属性、命名空间与可选字段的边界情况
Schema 常见约束：字段带 xmlns 前缀、元素含 xsi:type 属性、某些子节点 maxOccurs="unbounded"。这些不能靠“自动反射”解决，必须显式控制。
例如 Schema 要求 <person xmlns="http://example.com/v1" xsi:type="PersonType">，而 tinyxml2 默认不支持命名空间前缀绑定，得手动调用 SetAttribute() 写死属性：
立即学习“C++免费学习笔记（深入）”；
doc.InsertEndChild(doc.NewElement("person"));
auto* person = doc.FirstChildElement("person");
person->SetAttribute("xmlns", "http://example.com/v1");
person->SetAttribute("xsi:type", "PersonType"); // 注意 xsi 需提前声明
容易踩的坑：
-
xsi命名空间本身需在根节点声明：SetAttribute("xmlns:xsi", "http://www.w3.org/2001/XMLSchema-instance") - 可选字段为空时，**跳过创建该 Element**，而非创建空标签——否则违反
minOccurs="0"的语义 - 重复元素（如多个
<phone>）用循环 +LinkEndChild()，别反复InsertEndChild()导致顺序错乱
验证序列化结果是否符合 XSD Schema
写完序列化代码不等于合规。必须用外部工具做 XSD 验证，否则上线后被对方系统拒收才排查就晚了。
推荐命令行快速验证（Linux/macOS）：
xmllint --schema schema.xsd output.xml --noout
若报错 Element 'xxx': This element is not expected.，大概率是大小写不符（Schema 要 FirstName，你写了 firstname）或缺失必需属性；若报 Invalid datetime，检查时间格式是否含时区、秒是否带小数位。
- 开发阶段把验证步骤加入 CMake
add_custom_target，每次构建自动生成并校验 XML - 对
xs:enumeration字段（如状态码只能是"active"/"inactive"），在序列化前加断言：assert(status == "active" || status == "inactive") - 不要依赖
tinyxml2的Print()输出直接人工核对——缩进和换行可能掩盖属性缺失
替换方案对比：Boost.PropertyTree vs PugiXML vs 手写
Boost.PropertyTree 表面简单，但实际不满足 Schema 合规需求：它不支持命名空间、无法控制属性顺序、布尔输出为 1/0 而非 true/false，且 write_xml() 生成的文档默认无 encoding 声明，XSD 验证常因编码问题失败。
PugiXML 功能更全，支持 XPath 和命名空间，但 API 更复杂；其 xml_node::set_name() 和 append_attribute() 语义清晰，适合中等复杂度 Schema。不过若项目已用 tinyxml2，没必要为单次序列化引入新依赖。
- 手写 tinyxml2：适合字段 ≤20 个、Schema 稳定、团队熟悉 C++ 指针管理
- PugiXML：适合需后续 XPath 查询、或已有大量 XML 处理逻辑的项目
- 完全规避：如果 Schema 极复杂（含嵌套 choice/group），考虑用 xsd.exe 生成 C++ 类（Windows）或 xsdcxx（跨平台），但会增加构建链依赖
最易被忽略的一点：所有序列化函数必须声明为 const 成员函数，除非你要在序列化过程中修改对象状态——这违反单一职责，且会导致多线程下不可重入。
