C++如何解析XML文件-C++-PHP中文网

tinyxml2是c++解析xml最轻量且靠谱的选择：单头文件、零依赖、utf-8支持、api清晰；需注意bom处理、text()判空、属性安全读取、xmlprinter保存及迭代遍历防栈溢出。

c++如何解析xml文件

直接说结论：C++ 标准库不提供 XML 解析能力，别折腾 libxml2 的 C 风格 API 或自己手写 SAX；tinyxml2 是当前最实用的方案——头文件仅一个 tinyxml2.h，编译零依赖，支持 UTF-8，API 清晰，错误提示也够用。

常见错误现象：用 rapidxml 时遇到中文乱码（它默认不处理 BOM 和编码声明）；用 pugixml 时忘记调用 load_string() 后检查 document::error_id()，导致解析失败却静默继续。

下载地址是 GitHub 上的 tinyxml2 官方 repo，直接把 tinyxml2.h 和 tinyxml2.cpp 加进项目即可
Windows 下若读取含 BOM 的 UTF-8 文件，需用 fopen(..., "rb") + 自己跳过 BOM 字节，否则 LoadFile() 会报 TIXML2_ERROR_PARSING_ELEMENT
Linux/macOS 下用 LoadFile() 直接读 UTF-8 文件基本没问题，但路径含中文时要确保程序运行环境 locale 支持 UTF-8

Text() 返回的是指针，如果节点没文本子节点（比如 <name></name> 或 <name></name>），它返回 nullptr —— 不是空字符串。很多代码直接 std::string(val->Text()) 会崩溃。

正确做法是先判空再转：

const char* text = elem->Text();
std::string value = text ? text : "";

更安全的封装可以写成工具函数，但至少每次调用 Text() 都得加这层判断。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

tinyxml2 的文档对象修改后不会自动同步到原始文件。想保存，得用 XMLPrinter 打印成字符串再写入磁盘，而不是把 XMLDocument 对象 memcpy 到文件里。

典型错误：把 doc.SaveFile("out.xml") 当作“保存修改”，其实它只在首次加载时有效；后续改完必须用 XMLPrinter 显式输出：

tinyxml2::XMLPrinter printer;
doc.Accept(&printer);
FILE* f = fopen("out.xml", "wb");
fwrite(printer.CStr(), 1, printer.Size(), f);
fclose(f);

如果只是临时生成 XML 片段（比如拼 JSON 风格配置），直接用 printer.CStr() 取 const char* 即可，不用额外分配 string
Windows 下务必用 "wb" 模式打开文件，否则换行符会被转成 \r\n 导致格式错乱
XMLPrinter 默认不缩进，如需可构造时传 true：XMLPrinter printer(nullptr, true)

tinyxml2 的 DOM 树是链表+指针结构，深度嵌套（比如上千层 <item><item><item>...</item></item></item>）下递归遍历会触发栈溢出，尤其在 Windows 默认栈大小（1MB）下。

解决方案不是加大栈，而是改用迭代方式遍历：

for (auto elem = doc.FirstChildElement(); elem; elem = elem->NextSiblingElement()) {
    // 处理 elem
}

避免写 ProcessNode(node->FirstChildElement()) 这类纯递归函数
如需保留上下文（比如层级计数），用 std::stack<:xmlelement> 手动模拟递归栈
对超大 XML（>50MB），考虑换 streaming 方式（如 pugixml 的 xml_parse_result + cursor），tinyxml2 不适合流式解析

真正麻烦的从来不是“怎么读 XML”，而是编码一致性、空节点容错、以及修改后如何可靠落盘——这些点漏掉任意一个，都会让程序在某个客户环境突然失效，而且很难复现。