LoadFile()失败不报错，需检查返回值是否为XML_SUCCESS及LastErrorID()；取文本应优先用FirstChildElement()->GetText()；遍历同名元素用FirstChildElement()和NextSiblingElement()；中文需确保XML文件为UTF-8无BOM。
tinyxml2::XMLDocument::LoadFile() 失败但没报错？检查返回值和 LastErrorID()
很多同学调用 LoadFile() 后发现 doc.RootElement() 是空指针，却没意识到它根本不抛异常——失败只靠返回值和错误码。默认情况下它静默失败，不打印任何提示。
-
LoadFile()返回tinyxml2::XML_SUCCESS才算成功，否则必须查doc.LastErrorID() - 常见错误码：
TIXML2_ERROR_FILE_COULD_NOT_BE_OPENED（路径错/权限不足）、TIXML2_ERROR_PARSING_ELEMENT（XML 格式非法，比如标签没闭合） - 路径尽量用绝对路径测试，避免相对路径在 IDE 或不同工作目录下失效；Windows 下注意反斜杠要写成
"\"或用正斜杠"/"
取文本内容总为空？优先用 FirstChildElement()->GetText() 而非 FirstChild()->Value()
XML 节点结构比想象中“厚”：一个 <name>Alice</name> 实际包含 Element 节点 + Text 子节点。直接调 FirstChild()->Value() 很容易拿到空或意外字符串（比如换行符、空白），因为 Value() 返回的是节点名（Element）或文本内容（Text），但你未必知道当前节点类型。
- 安全做法：先定位到目标 Element，再调
GetText()—— 它会跳过空白节点，直接返回子 Text 节点的内容 - 错误写法：
doc.FirstChildElement("user")->FirstChild()->Value()→ 可能是" "或null - 正确写法：
doc.FirstChildElement("user")->FirstChildElement("name")->GetText()→ 直接得"Alice"（如果存在且非空） - 如果不确定子元素是否存在，
GetText()返回nullptr，记得判空再用
遍历同名子元素别用 FirstChild() 套循环，用 NextSiblingElement()
想读多个 <item>，有人写 el->FirstChild()->NextSiblingElement()，结果漏掉第一个或崩溃。tinyxml2 的链表结构里，FirstChild() 返回的是第一个子节点（可能是 Text、Comment 或 Element），不是第一个同名 Element。
- 正确方式：用
FirstChildElement("item")拿第一个，再用NextSiblingElement("item")遍历后续同名兄弟节点 - 这样能自动跳过注释、空白、其他标签，只命中你要的
<item> - 示例：
for (auto* item = root->FirstChildElement("item"); item; item = item->NextSiblingElement("item")) { const char* id = item->Attribute("id"); // 取属性 const char* text = item->GetText(); // 取内容 }
中文乱码？别动 XMLDocument 编码设置，确保文件本身是 UTF-8 无 BOM
tinyxml2 默认按 UTF-8 解析，它不读 XML 声明里的 encoding="gb2312"，也不做编码转换。所谓“加 doc.SetEncoding("UTF-8") 就能解决”是误解——这个函数只影响输出，不影响输入解析。
立即学习“C++免费学习笔记（深入）”；
- 真正有效的方法：把 XML 文件存为 UTF-8 无 BOM 格式（VS Code / Notepad++ 都可设）
- 如果原始文件是 GBK，要么转码，要么改用支持编码探测的库（如 pugixml），tinyxml2 不处理这个
- 验证方法：用十六进制编辑器看文件开头，UTF-8 无 BOM 就是纯文本字节，没有
EF BB BF
实际用下来，最常卡住的不是语法，而是错误处理没跟上、节点类型没分清、还有那个藏得极深的文件编码问题。尤其多人协作时，XML 文件编码状态容易被编辑器悄悄改掉，一模一样的代码换个机器就崩。
