tinyxml2是C++读XML最省心的选择，轻量稳定、零第三方依赖、全平台UTF-8/UTF-16支持；常见问题包括路径错误、编码不匹配或XML语法错误，需检查LoadFile返回值并确保编码一致。
用 tinyxml2 读 XML 是最省心的选择
绝大多数 C++ 项目不需要自己手写解析器，tinyxml2 足够轻、够稳、接口直白。它不依赖 STL 以外的第三方库，编译进项目几乎零摩擦，Windows/Linux/macOS 全平台默认支持 UTF-8 和 UTF-16（含 BOM）。
常见错误现象：XMLDocument::LoadFile() 返回 tinyxml2::XML_SUCCESS 却拿不到根节点，往往是文件路径错、编码非 UTF-8 且没声明、或 XML 本身有语法错误（比如未闭合标签）。
- 确保文件路径是绝对路径，或工作目录与预期一致；相对路径容易在 IDE 运行和命令行运行时行为不一致
- 加载后务必检查返回值：
auto err = doc.LoadFile("config.xml"); if (err != tinyxml2::XML_SUCCESS) { /* 打印 doc.ErrorIDToName(err) */ } - 如果 XML 带 BOM 或声明了
<?xml version="1.0" encoding="GBK"?>，tinyxml2默认不处理 GBK——要么转成 UTF-8 存储，要么自己先用iconv或std::codecvt_utf8（C++17 已弃用）预转换
rapidxml 比 tinyxml2 快但更难驾驭
rapidxml 是纯头文件、零内存分配（除原始 XML 缓冲区外）、解析速度通常比 tinyxml2 高 2–3 倍，但它把“易用性”让渡给了“控制力”。它修改原始 XML 字符串（零拷贝），且节点生命周期完全绑定于你传入的 buffer。
典型翻车点：rapidxml::xml_document<> doc; doc.parse<0>(buffer); 中的 buffer 必须在整个文档使用期间保持有效；一旦 buffer 被 std::string 释放或局部数组出作用域，所有 xml_node 指针立刻悬空。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 别用
std::string::c_str()直接传给parse()，除非你显式保证该std::string的 lifetime 长于xml_document - 若需多线程并发解析，每个线程必须用独立的
xml_document实例——它不是线程安全的 - 没有内置编码转换，遇到
encoding="UTF-16"会直接解析失败，得自己先把 buffer 转成 UTF-8 再喂进去
别碰 MSXML 和 libxml++ 在跨平台项目里
MSXML 是 Windows 专属 COM 组件，硬绑 IE 引擎，Win10/Win11 默认策略已限制其加载；libxml++ 是 C++ 封装层，底层依赖 libxml2，但它的构建链（pkg-config + glibmm）在 Windows 上极易卡死，CMake 支持弱，VS 用户基本要手动配 .lib 和头文件路径。
实际场景中，这两个库只在两类情况值得考虑：已有大型 Windows MFC 项目强依赖 MSXML；或 Linux 服务端已深度集成 GNOME 生态并用 glib 管理内存。
- 新项目选它们，等于主动给自己加 CI 构建复杂度和跨平台维护成本
-
libxml2本体其实很成熟，但直接用 C 接口（xmlParseFile）比用libxml++更可控——不过依然不如tinyxml2简单 - 如果你只是读配置、不写、不验证 schema，真没必要为“标准兼容性”牺牲开发效率
读取时最容易被忽略的细节
XML 不是 JSON，空格、换行、缩进默认是有效内容。比如 <name>\n Alice\n</name>，用 FirstChildElement()->GetText() 拿到的是 "\n Alice\n"，不是 "Alice"；而 FirstChild()->Value() 可能返回 #text 节点，内容还是带换行的字符串。
- 提取文本前先调用
node->FirstChildElement()跳过空白text节点，再用child->GetText() - 用
node->FirstChildElement("tag")比node->FirstChild()->NextSiblingElement("tag")更安全——前者自动跳过注释、CDATA、空白 text 节点 - 属性值默认不转义，但
node->Attribute("attr")返回的是解码后的字符串；而node->FirstAttribute()的Value()是原始字节，含实体引用（如
真正麻烦的从来不是“怎么读”，而是“读到的内容到底算不算有效数据”——校验结构、处理空值、容忍格式差异，这些得靠业务逻辑兜底，库不会替你决定。
