用tinyxml2库最省事，它轻量、头文件即用、无依赖，适合结构体到XML字符串的单向序列化；需手动转义特殊字符、处理UTF-8编码、避免嵌套错位，并推荐用vector封装字段统一生成。
用 tinyxml2 库最省事，别自己手写 XML 生成逻辑
直接手拼 <tag>value</tag> 容易漏转义、嵌套错位、属性引号不匹配，出问题很难 debug。tinyxml2 是轻量、头文件即用、无依赖的 C++ XML 库，适合结构体到字符串的单向序列化（不需要反序列化时更简单）。
实操建议：
- 下载
tinyxml2.h和tinyxml2.cpp放进项目目录，#include "tinyxml2.h"即可，不用编译额外库 - 结构体字段名需映射为 XML 标签名——命名不能含空格、斜杠、冒号等非法字符，建议用
std::string或const char*字段存标签名 - 数值类型（
int、double）要转成字符串再插入，用std::to_string()或std::sprintf，别直接传数字给SetText() - 中文字段值必须调用
doc.SetBOM(true)并确保源文件是 UTF-8 编码，否则输出乱码
结构体字段多时，用递归函数避免重复写 XMLNode::InsertEndChild()
手动为每个字段写一行 doc.NewElement("name") + ele->SetText(...) + root->InsertEndChild(ele) 很容易漏掉某一项，尤其字段超过 5 个后维护成本陡增。
推荐做法：
立即学习“C++免费学习笔记（深入）”；
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 把结构体字段抽象成
std::vector<std::pair<std::string, std::string>>，键是标签名，值是字符串化内容 - 写一个通用函数
void addElements(tinyxml2::XMLElement* parent, const std::vector<std::pair<std::string, std::string>>& fields)，循环调用NewElement和SetText - 嵌套结构体（如
struct Address { std::string city; int zip; };）单独序列化为子节点，再作为fields中的一个项传入，不要在主函数里展开
std::string 字段含特殊字符（<、&、"）会破坏 XML 结构
tinyxml2 默认不自动转义文本内容，如果结构体里有 std::string msg = "price < $10";，直接 ele->SetText(msg.c_str()) 会导致生成的 XML 无法被解析（< 被当成新标签起始）。
必须处理：
- 对每个字符串字段，在塞进
SetText()前做 HTML 实体转义：<→，<code>>→>，&→&，"→" - 别依赖第三方转义函数——tinyxml2 不提供内置转义，自己写一个简短替换函数比引入
boost::algorithm::replace_all更轻量 - 注意：属性值（
ele->SetAttribute("key", value.c_str())）也需同样转义，tinyxml2 不自动处理
生成字符串时别漏掉 doc.ToString() 后的内存清理和换行控制
调用 tinyxml2::XMLDocument::ToString() 返回的是带缩进和换行的格式化字符串，体积大、传输效率低；而直接用 doc.PrintFilter() 又需要自己管理缓冲区。
稳妥做法：
- 用
const char* xml_cstr = doc.ToString();获取 C 字符串，然后构造std::string xml_str(xml_cstr);——注意ToString()返回的指针生命周期只在doc对象有效期内 - 如果不需要换行缩进，创建文档时加一句
doc.SetIndent(0);，否则默认缩进 2 空格，每层嵌套都加换行 - 别在函数返回前销毁
doc，否则ToString()返回的指针指向已释放内存，得到乱码或崩溃
嵌套层级深、字段含二进制数据（比如 base64 编码的图片）时，XML 易膨胀且难调试，这种场景该考虑 Protocol Buffers 或 JSON。但纯配置导出、日志快照这类简单需求，tinyxml2 + 手动转义就是最稳的路径。
