C++怎么解析XML TinyXML-2库使用入门教程

畫卷琴夢 2025-12-12 00:00:00 次阅读

TinyXML-2解析XML只需三步：加载文档→查找节点→提取数据；轻量、头文件即用、无依赖，适合嵌入式或中小型项目。

用 TinyXML-2 解析 XML 很简单，核心就三步：加载文档 → 查找节点 → 提取数据。它轻量、头文件即用、不依赖其他库，适合嵌入式或中小型项目。

一、快速开始：编译与包含

下载 tinyxml2.h 和 tinyxml2.cpp（官网或 GitHub 可得），直接加入你的工程。C++ 项目只需：

在源文件顶部加 #include "tinyxml2.h"
确保 tinyxml2.cpp 被编译进项目（不是头文件包含就行）
无需链接额外库，无 CMake 复杂配置

二、读取并解析一个 XML 文件

假设你有如下 config.xml：

  MyTool
  2.1

代码这样写：

tinyxml2::XMLDocument doc;
XMLError err = doc.LoadFile("config.xml");
if (err != XML_SUCCESS) {
    std::cerr << "加载失败：" << doc.ErrorName() << std::endl;
    return;
}
tinyxml2::XMLElement* root = doc.RootElement(); // 
if (!root) return;
const char name = root->FirstChildElement("name")->GetText(); // "MyTool"
const char ver  = root->FirstChildElement("version")->GetText(); // "2.1"
tinyxml2::XMLElement* debug = root->FirstChildElement("debug");
bool isDebug = debug && std::string(debug->Attribute("enabled")) == "true";

三、常用操作速查

取文本内容：用 GetText()，注意返回 const char*，节点为空时返回 nullptr
取属性值：用 Attribute("attr_name")，同样可能为 nullptr
遍历子节点：用 FirstChildElement() 或循环 NextSiblingElement()
安全访问：每一步都建议判空，TinyXML-2 不抛异常，空指针解引用会崩溃

四、写 XML（简单输出）

构建并保存也很直观：

tinyxml2::XMLDocument doc;
auto* root = doc.NewElement("log");
doc.InsertFirstChild(root);
auto* item = doc.NewElement("entry");
item->SetText("Startup completed");
root->InsertEndChild(item);
doc.SaveFile("output.xml"); // 自动缩进，可读性强

基本上就这些。不复杂但容易忽略空指针检查——多写两行 if，省去调试半小时。