tinyxml2是C++写XML最省心的选择：轻量、易集成、错误处理清晰；需设BOM、用UTF-8、正确嵌套节点并检查ErrorID。
用 tinyxml2 写 XML 文件最省心
直接上结论：C++ 没有标准 XML 库，tinyxml2 是当前最轻量、最易集成、错误处理最清晰的选项。别碰 libxml2（C 风格重、头文件多、编译容易崩），也别自己拼字符串（格式错一个引号就无效，且无法自动转义 & <code>>）。
常见错误现象：TiXmlDocument::SaveFile() 返回 false 但没查 errorID()；中文写入乱码（没设编码声明或没用 UTF-8 字节序）；节点嵌套漏 LinkEndChild() 导致内存泄漏或段错误。
- 下载源码后只须引入
tinyxml2.h和tinyxml2.cpp到项目，零依赖 - 写入前务必调用
doc.SetBOM(true)，否则 Windows 记事本可能显示乱码 - 所有文本内容用
XMLText节点，不要用XMLComment或裸字符串赋值 - 中文字符串必须是 UTF-8 编码（例如
"姓名"而非 GBK 字节数组）
写一个带属性和子节点的 XML 示例
典型场景：导出配置或日志数据，比如保存用户信息。关键不是“能不能写”，而是“节点层级是否闭合”“属性值是否被正确引号包裹”“特殊字符是否自动转义”。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 先用
XMLDocument doc创建文档对象 - 用
doc.NewElement("user")创建根节点，再用doc.NewText("张三")创建文本内容 - 属性必须用
SetAttribute("id", "1001")，不能写成element->Value() = "id=1001" - 每新建一个子节点，必须显式调用
parent->InsertEndChild(child)，否则不生效
简短示例：
XMLDocument doc;
doc.SetBOM(true);
XMLElement* root = doc.NewElement("users");
doc.InsertFirstChild(root);
<p>XMLElement<em> user = doc.NewElement("user");
user->SetAttribute("id", "1001");
XMLElement</em> name = doc.NewElement("name");
name->InsertEndChild(doc.NewText("张三"));
user->InsertEndChild(name);
root->InsertEndChild(user);</p><p>doc.SaveFile("output.xml");</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/gongju/2823" title="C++14">C++14</a>
<p>C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>为什么不用 std::ofstream 直接写字符串
能写出来，但很快会踩坑：生成的 XML 不合法。比如用户昵称含 &，手动拼串会变成 &（双重转义），而 tinyxml2 自动处理为 &；再如换行缩进全靠自己算，可读性差，解析器虽容忍但调试极痛苦。
性能影响几乎可忽略——tinyxml2 内存中构建 DOM，最后一次性写磁盘，比反复 ofstream << 更快；兼容性上，它输出纯 ASCII 声明 + UTF-8 内容，所有主流解析器都认。
- 手写字符串时，
"<tag>" + value + "</tag>遇到value == "a<b"就直接破坏结构 - 没有自动缩进，
output.xml变成一行超长字符串，diff 工具失效 - 无法验证结构合法性（比如未闭合标签），只能靠肉眼或外部工具事后检查
生成失败时怎么快速定位
核心就一条：永远检查 doc.ErrorID() 和 doc.ErrorStr()，而不是只看 SaveFile() 返回值。
常见错误类型与对应动作：
-
XML_ERROR_FILE_COULD_NOT_BE_OPENED→ 检查路径权限、目录是否存在、路径含中文是否被截断 -
XML_ERROR_PARSING_ELEMENT→ 实际是写入前 DOM 构建出错，回溯最近一次NewElement或SetAttribute的参数是否为空指针 -
XML_ERROR_INVALID_UNICODE→ 输入字符串不是合法 UTF-8，可用std::isprint((unsigned char)c)快速筛非法字节
调试技巧：临时加一句 doc.Print(); 到控制台，看结构是否符合预期——这比打开文件查更直接。
真正麻烦的点不在“怎么写”，而在“写完别人能不能安全读”。哪怕只是临时导出，也要确保编码声明、转义、嵌套层级三者一致。不然下游 Python 或 Java 解析时抛异常，问题就甩锅给你了。
