TinyXML2是C++中轻量易用的XML解析库,支持加载、遍历、读取属性/文本、数值转换及生成XML;使用时需检查错误码、注意空指针、循环遍历同名元素,并确保UTF-8编码。

用 C++ 解析 XML,TinyXML2 是最轻量、易上手的选择之一。它不依赖外部库,头文件即用,适合嵌入式、工具脚本或中小型项目。
一、快速开始:加载并读取 XML 文件
先确保已将 tinyxml2.h 和 tinyxml2.cpp 加入工程(或通过 vcpkg/conan 安装)。基本流程是:加载文档 → 查找根节点 → 遍历子元素。
- 用 XMLDocument::LoadFile() 读取本地 XML 文件,返回值为 XMLError,需检查是否成功(0 表示成功)
- 调用 XMLDocument::RootElement() 获取根元素(XMLElement*),若为空说明文档结构异常或为空
- 根节点本身也是 XMLElement,支持 FirstChildElement("TagName")、NextSiblingElement("TagName") 等链式查找
二、提取元素内容与属性
XML 元素的内容(text)和属性(attribute)需分别获取,注意空指针安全。
- 文本内容:调用 XMLElement::GetText(),返回 const char*;若元素含子节点(如混合内容),该函数返回 nullptr,此时应遍历 FirstChild() 并判断 XMLNode::ToText()
- 属性值:用 XMLElement::Attribute("name") 直接获取 const char*;支持带默认值的重载 Attribute("name", &defaultValue)
- 数值转换:TinyXML2 提供 QueryIntAttribute()、QueryDoubleText() 等方法,失败时返回非零错误码,推荐配合 if 判断使用
三、遍历所有同名子元素
当存在多个相同标签(如
立即学习“C++免费学习笔记(深入)”;
- 从根节点调用 FirstChildElement("item") 得到首个 item 元素
- 后续用 element->NextSiblingElement("item") 向下迭代,直到返回 nullptr
- 每轮循环中可重复调用 FirstChildElement() 访问其子项(如
、 ),无需递归函数也能清晰处理层级
四、写入 XML(生成/修改后保存)
TinyXML2 同样支持构建和输出 XML 文档,适合配置保存或数据导出。
- 创建新文档:XMLDocument doc;,用 doc.NewElement("root") 创建节点,doc.NewText("value") 创建文本节点
- 组装结构:用 parent->InsertEndChild(child) 添加子节点,支持链式调用(如 root->InsertEndChild(doc.NewElement("item"))->SetText("abc"))
- 保存文件:doc.SaveFile("output.xml"),返回 XMLError;也可用 doc.Printer() 获取字符串内容(需自行分配缓冲区或用 std::string 配合)
不复杂但容易忽略:中文路径或含中文文本时,确保源文件编码为 UTF-8(无 BOM),TinyXML2 默认按 UTF-8 解析,无需额外设置。











