pugixml是轻量、零依赖、纯头文件的C++ XML解析库，采用DOM模式，解析快但内存占用与XML大小成正比，不支持流式解析；需UTF-8无BOM输入，C++11起可用，通过xml_document加载后遍历节点。
直接说结论：pugixml 是轻量、零依赖、纯头文件的 C++ XML 解析库，适合需要高性能且不希望引入 Boost 或 libxml2 的场景；它默认用 DOM 模式加载整棵树，解析快、API 简洁，但内存占用与 XML 大小成正比——不是流式（SAX）解析器，超大文件需自行分块或换方案。
怎么快速开始：包含头文件 + 读取并遍历 XML
pugixml 不需要编译安装，下载 pugixml.hpp（单头文件）放进项目目录即可。注意它默认启用 UTF-8，若 XML 声明含 <?xml version="1.0" encoding="GBK"?>，需先转码或手动指定编码（见下文）。
- 确保编译器支持 C++11（最低要求），
#include "pugixml.hpp" -
pugi::xml_document是核心容器，调用load_file()或load_string()加载 - 节点遍历用
child()/first_child()/next_sibling()，属性用attribute()
#include "pugixml.hpp"
#include <iostream>
<p>int main() {
pugi::xml_document doc;
pugi::xml_parse_result result = doc.load_file("config.xml");
if (!result) {
std::cerr << "Parse error: " << result.description() << "\n";
return -1;
}</p><pre class='brush:php;toolbar:false;'>// 查找根下所有 <item> 节点
for (pugi::xml_node item = doc.child("root").child("item"); item; item = item.next_sibling("item")) {
const char* name = item.attribute("name").as_string();
const char* value = item.child_value("value"); // 获取子文本节点内容
std::cout << name << " = " << (value ? value : "") << "\n";
}}
常见解析失败原因：编码、BOM、格式错误
pugixml 默认按 UTF-8 解析，遇到带 BOM 的 UTF-8 文件或 GBK/UTF-16 文件会直接报 status_bad_encoding；它也不容忍语法错误（如未闭合标签），报错位置精确但不自动修复。
立即学习“C++免费学习笔记（深入）”；
- Windows 记事本保存的 XML 常带 UTF-8 BOM（
EF BB BF），pugixml 无法跳过——要么用其他编辑器另存为“UTF-8 无 BOM”，要么用load_buffer()手动跳过前 3 字节 - 非 UTF-8 编码（如 GBK）必须先转成 UTF-8 再传给 pugixml，库本身不提供编码转换
- 错误信息通过
xml_parse_result::description()返回，典型值有：status_file_not_found、status_io_error、status_unrecognized_tag
怎么安全提取数据：避免空指针和越界访问
pugixml 的 API 返回的是轻量代理对象（xml_node、xml_attribute），它们可隐式转 bool 判断是否有效，但直接调用 text().get() 或 attribute("x").as_int() 在无效时会返回默认值（如 0 或空字符串），**不会崩溃，但可能掩盖逻辑错误**。
- 始终先检查节点/属性是否存在：
if (node && node.attribute("id")) { ... } - 用
attribute("x").as_int(-1)显式设默认值，避免误把缺失属性当 0 - 获取文本内容优先用
child_value("tag")（返回 C 字符串），而非child("tag").text().get()（需确保子节点存在且含文本） - 迭代子节点时，用
for (auto child : node.children())更安全（C++11 范围 for，内部已判空）
性能关键点：DOM 树生命周期与内存管理
pugixml 解析后整个树驻留在内存，节点对象只是指向内部缓冲区的视图；xml_document 析构时才释放全部内存。这意味着：
- 不要长期持有来自已销毁
xml_document的xml_node变量（悬垂引用，行为未定义） - 频繁解析不同 XML？复用同一个
xml_document对象（调用reset()清空再load_*），避免反复 malloc/free - 若只读少量字段（如配置项），用
select_node()+ XPath 表达式比遍历整棵树更简洁，但 XPath 解析有额外开销，简单结构推荐直接导航 - 极端性能场景可启用
PUGIXML_COMPACT宏编译，减少内存占用约 20%，但调试信息丢失
真正的大文件（>100MB）别硬扛 DOM —— pugixml 不是流式解析器。这时候得切回 SAX 思路（比如用 xml_parser 类配合自定义 handler），或者换用基于事件的库（如 expat），否则 OOM 风险很高。
