用tinyxml2::xmldocument构造函数创建空文档并调用savefile()保存;节点须用newelement()等工厂方法创建并linkendchild()挂载,savefile()返回xmlerror需检查。

怎么用 TinyXML2 创建一个空 XML 文档并写入文件
直接调用 tinyxml2::XMLDocument 构造函数就能得到一个空文档对象,它默认已包含 XML 声明(<?xml version="1.0" encoding="UTF-8"?>)。保存前必须显式调用 SaveFile(),否则内存中的改动不会落地。
-
SaveFile()返回tinyxml2::XMLError,非零值表示失败(如路径无写权限、父目录不存在),务必检查返回值,不能只看是否崩溃 - 路径支持相对路径,但当前工作目录由运行环境决定,建议用绝对路径或提前确认
chdir()状态 - 如果只是想生成字符串而不写磁盘,用
XMLPrinter配合Accept(),不是SaveFile()
怎么添加根节点和子节点
节点必须通过所属文档的工厂方法创建(如 NewElement()、NewText()),不能直接 new。所有节点需用 LinkEndChild() 或 InsertEndChild() 挂到父节点下,否则是孤立节点,序列化时不会出现。
- 根节点只能有一个,重复调用
LinkEndChild()到文档会失败(返回XML_WRONG_TYPE) -
SetText()会自动创建XMLText子节点;若要保留空白或换行,改用LinkEndChild(NewText("...")) - 属性用
SetAttribute()添加,不支持命名空间(TinyXML2 本身不解析 namespace)
示例:创建 <config><port>8080</port></config>
tinyxml2::XMLDocument doc;
auto root = doc.NewElement("config");
auto port = doc.NewElement("port");
port->SetText(8080); // 自动转为字符串
root->LinkEndChild(port);
doc.LinkEndChild(root);
doc.SaveFile("config.xml");
为什么保存后中文乱码或格式错乱
TinyXML2 默认以 UTF-8 编码写入,且不带 BOM。乱码通常是因为编辑器误判编码(如用 GBK 打开 UTF-8 文件),而非库本身问题。格式错乱则多因手动拼接换行/缩进——TinyXML2 不提供自动美化输出,SaveFile() 生成的是紧凑格式。
- 若需可读性格式,启用
XMLPrinter的缩进参数:XMLPrinter printer(nullptr, true, 2)(2 为空格数),再调用doc.Accept(&printer),最后用printer.CStr()获取字符串 - Windows 记事本打开 UTF-8 无 BOM 文件会显示乱码,这是记事本缺陷,换 VS Code 或 Notepad++ 即可
- 不要尝试用
SetAttribute("encoding", "GBK"),XML 声明里的 encoding 是提示解析器用什么编码读,实际写入仍是 UTF-8,强行改会导致解析失败
常见错误:节点生命周期和内存管理
TinyXML2 节点全部由文档管理内存,不能在文档销毁后访问其节点指针,也不能跨文档移动节点(LinkEndChild() 会断言失败)。局部变量存节点指针没问题,但文档对象必须比所有子节点活得久。
- 把
XMLDocument放在栈上?可以,但确保所有操作(包括SaveFile())都在其作用域内完成 - 用
new XMLDocument?可以,但必须配对delete,且不能只 delete 子节点 - 调用
Clear()会释放所有节点内存,之后不能再用之前创建的节点指针
最容易被忽略的是:FirstChildElement() 等查找接口返回的指针,在文档被修改(如新增同级节点)后仍有效,但文档析构后立刻失效——这点和 DOM API 直觉不同,容易踩空悬垂指针。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











