tinyxml2是C++最轻量实用的XML解析方案——单头文件、无依赖、API直观，适合配置读取；需正确使用LoadFile/GetText/NextSiblingElement，注意UTF-8编码与空值处理。
用 tinyxml2 解析 XML 是最轻量且够用的选择
直接上结论：C++ 标准库不提供 XML 解析能力，tinyxml2 是当前最实用的第三方方案——头文件仅一个 tinyxml2.h，无依赖、编译快、API 直观，适合绝大多数配置读取或简单数据交换场景。
别碰 libxml2（C 风格 API 繁琐）、也别试 pugixml（功能强但默认启用大量宏和异常，容易在嵌入式或禁用异常的项目里翻车）。
实操建议：
- 下载
tinyxml2.h和tinyxml2.cpp放进工程目录，直接#include "tinyxml2.h" - 链接时确保
tinyxml2.cpp参与编译（不是只 include 头文件） - 解析失败时，
XMLDocument::Parse()返回非XML_SUCCESS，但错误信息藏在XMLDocument::ErrorID()和XMLDocument::ErrorStr()里，不查就只能看到空指针 - 用
XMLDocument::LoadFile(const char*)读文件更安全，它自动处理 BOM 和编码探测；Parse()仅适合已知是 UTF-8 的内存字符串
读取节点内容时，别直接用 Text() 获取文本值
Text() 返回的是节点内「纯文本内容」，但它可能为 nullptr（比如节点含子元素、或只有空白符），而且不跳过注释或 CDATA。实际读取时极易 crash 或漏数据。
立即学习“C++免费学习笔记（深入）”；
正确做法是统一用 FirstChildElement() 定位元素，再用 GetText() 或 QueryStringValue() 提取值：
tinyxml2::XMLDocument doc;
doc.LoadFile("config.xml");
auto root = doc.FirstChildElement("config");
if (root) {
const char* port_str = root->FirstChildElement("port")->GetText(); // 安全：返回 nullptr 或 C 字符串
int port = port_str ? atoi(port_str) : 8080;
}
注意：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
GetText()自动跳过空白文本节点，且返回const char*，无需判空也能安全传给atoi/strtol - 如果字段可选，用
QueryStringValue()更合适——它返回nullptr而非空字符串，语义更清晰 - 数值类型务必自己转换：
tinyxml2不提供QueryIntValue()等封装，强行调用会忽略溢出和非法格式
遍历同名子节点必须用 NextSiblingElement()，不能靠循环索引
XML 中重复标签（如 <item></item> 多个）很常见，但 tinyxml2 没有类似 Python 的 findall() 接口。误用 FirstChildElement("item")->NextSiblingElement("item") 写法会导致漏掉第一个节点。
标准写法是“先取第一个，再循环 Next”：
for (auto item = root->FirstChildElement("item"); item != nullptr; item = item->NextSiblingElement("item")) {
const char* name = item->QueryStringValue("name");
const char* value = item->QueryStringValue("value");
// 处理每个 item
}
关键点：
- 条件判断写成
item != nullptr，不是item——避免 clang-tidy 报 warning - 参数传
"item"是为了跳过其他类型兄弟节点（如注释、文本），不传则遍历所有兄弟 - 如果 XML 结构深度不确定，别用递归遍历：tinyxml2 的节点树不支持 parent 指针回溯，容易栈溢出
中文路径或含中文内容时，Windows 下要小心编码
Windows 默认 ANSI 编码（如 GBK），而 tinyxml2 假设输入是 UTF-8。直接传 std::string 路径或内容，中文会乱码甚至解析失败（XML_ERROR_PARSING_TEXT）。
解决方案分两步：
- 读文件路径：用
MultiByteToWideChar(CP_ACP, ...)转成wchar_t*，再用_wfopen打开并读为 UTF-8std::string，最后喂给XMLDocument::Parse() - 或更简单：强制把 XML 文件存为 UTF-8 with BOM，
LoadFile()能自动识别 BOM 并正确解码 - 运行时生成的 XML 字符串，确保
std::string存的是 UTF-8 字节序列（不是本地编码），否则Parse()会静默失败
Linux/macOS 下通常无此问题，但跨平台项目仍建议统一用 UTF-8 文件 + BOM。
