TinyXML2 是轻量级 C++ XML 解析库,通过包含 tinyxml2.h 和 tinyxml2.cpp 文件即可集成,使用 XMLDocument 加载文件,遍历 DOM 树获取元素与属性,适合处理中小型 XML 数据。

TinyXML2 是一个轻量级、高效且易于使用的 C++ XML 解析库,适合读取和操作 XML 文件。它比原始的 TinyXML 更加现代化,内存占用更少,接口更清晰。下面介绍如何在 C++ 项目中使用 TinyXML2 来解析 XML 文件。
1. 安装与配置 TinyXML2
要使用 TinyXML2,首先需要获取并集成库文件到你的项目中:
- 下载源码:从 GitHub 仓库 https://github.com/leethomason/tinyxml2 克隆或下载源码。
- 编译并链接:将 tinyxml2.cpp 和 tinyxml2.h 添加到你的项目目录中。在大多数情况下,只需把这两个文件拖入工程即可,无需额外编译为静态库。
-
包含头文件:在源文件中使用
#include "tinyxml2.h"。
2. 基本 XML 结构示例
假设有一个名为 example.xml 的文件内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<books>
<book id="1">
<title>C++ Primer</title>
<author>Stanley Lippman</author>
<price currency="USD">59.99</price>
</book>
<book id="2">
<title>Effective Modern C++</title>
<author>Scott Meyers</author>
<price currency="EUR">45.00</price>
</book>
</books>
3. 加载并解析 XML 文件
使用 TinyXML2 读取该文件并提取信息的基本代码如下:
立即学习“C++免费学习笔记(深入)”;
#include <iostream>
#include "tinyxml2.h"
<p>using namespace tinyxml2;</p><p>int main() {
XMLDocument doc;
XMLError result = doc.LoadFile("example.xml");</p><pre class='brush:php;toolbar:false;'>if (result != XML_SUCCESS) {
std::cerr << "无法加载 XML 文件!错误代码:" << result << std::endl;
return -1;
}
// 获取根元素
const XMLElement* root = doc.RootElement();
if (!root) {
std::cerr << "XML 文件没有根元素!" << std::endl;
return -1;
}
// 遍历每个 book 子元素
for (const XMLElement* bookElem = root->FirstChildElement("book");
bookElem != nullptr;
bookElem = bookElem->NextSiblingElement("book")) {
int id;
bookElem->QueryIntAttribute("id", &id);
const char* title = bookElem->FirstChildElement("title")->GetText();
const char* author = bookElem->FirstChildElement("author")->GetText();
const XMLElement* priceElem = bookElem->FirstChildElement("price");
const char* currency = priceElem->Attribute("currency");
const char* price = priceElem->GetText();
std::cout << "ID: " << id
<< ", 书名: " << (title ? title : "N/A")
<< ", 作者: " << (author ? author : "N/A")
<< ", 价格: " << (price ? price : "N/A")
<< " " << (currency ? currency : "") << std::endl;
}
return 0;}
4. 关键 API 说明
- XMLDocument::LoadFile():加载 XML 文件,返回 XMLError 状态码。
- RootElement():获取文档根节点。
- FirstChildElement(tag):查找第一个指定标签名的子元素。
- NextSiblingElement(tag):遍历同级的下一个同名元素。
- Attribute("name"):获取元素的属性值(字符串)。
- QueryIntAttribute / QueryDoubleAttribute:安全地将属性转为整型或浮点数。
- GetText():获取元素内的文本内容。
注意:所有返回的 const char* 指针由 TinyXML2 内部管理,不应手动释放,也不建议长期持有指针。
基本上就这些。TinyXML2 上手快,结构清晰,非常适合中小型项目处理 XML 配置文件或数据交换格式。只要理解了 DOM 树的遍历方式,就能灵活提取所需信息。










