tinyxml2::XMLDocument::LoadFile()失败返回nullptr时，应立即检查ErrorID()和ErrorName()获取具体错误；常见原因包括文件路径错误、权限不足、BOM问题及XML语法错误。
tinyxml2::XMLDocument::LoadFile() 失败返回 nullptr 怎么查
加载 XML 文件失败时，XMLDocument::LoadFile() 返回 nullptr，但不抛异常，也不打印错误——这是最常卡住人的第一步。
真正该看的是 XMLDocument::ErrorID() 和 XMLDocument::ErrorName()，它们才告诉你具体哪错了。
- 先检查文件路径是否正确：相对路径以当前工作目录为准，不是源码目录，建议用绝对路径或打印
std::filesystem::current_path()确认 - 确保文件有读权限，Windows 下注意 BOM（UTF-8 with BOM 可能被误判为非法头）
- 调用
LoadFile()后立刻检查：if (doc.ErrorID() != XML_SUCCESS) { printf("Err: %s\n", doc.ErrorName()); } - 常见
ErrorName()值：XML_ERROR_FILE_NOT_FOUND、XML_ERROR_PARSING_ELEMENT（标签没闭合）、XML_ERROR_INVALID_HEX_CHARACTER_REF（非法字符实体）
遍历子节点时 FirstChildElement() 返回空指针的典型原因
FirstChildElement() 不是“找第一个子节点”，而是“找第一个类型为 ELEMENT 的子节点”——文本、注释、CDATA 都会被跳过。很多新手以为 XML 里换行缩进是“空白节点”，其实 tinyxml2 默认把空白文本节点也当 XMLText 节点处理，导致 FirstChildElement() 直接越过去。
- 确认 XML 是否含冗余空白：比如
<root>\n <item>1</item>\n</root>中的换行和空格会生成XMLText节点 - 解决办法一：构造
XMLDocument时传入XMLDocument(false)（禁用空白压缩），再手动跳过非 ELEMENT 节点 - 解决办法二：直接用
IterateChildren()+ 类型判断：for (auto* n = parent->FirstChild(); n; n = n->NextSibling()) { if (n->ToElement()) { /* 处理 */ } } - 别依赖
FirstChildElement("xxx")返回非空就认为结构存在——它只找第一个匹配名的 element，找不到就返回nullptr，不会报错也不会继续找
XMLElement::QueryIntAttribute() 读不到值或返回 XML_NO_ATTRIBUTE
这个函数不解析字符串，只做直译转换；一旦属性值含空格、单位（如 "10px"）、负号位置不对（如 "- 5"），或根本不存在，就失败。
立即学习“C++免费学习笔记（深入）”；
- 先用
XMLElement::Attribute("attr_name")拿原始字符串，确认值确实存在且格式干净 -
QueryIntAttribute()对"0"、"-123"有效，对" 42 "（带空格）、"42.0"、"0x2A"无效 - 如果属性可能缺失，别直接 assert，应检查返回值：
if (elem->QueryIntAttribute("id", &id) != XML_SUCCESS) { id = 0; } - 浮点数用
QueryFloatAttribute()，布尔用QueryBoolAttribute()，它们各自有独立的解析逻辑，不要混用
用 XMLNode::DeepClone() 复制节点后插入失败
DeepClone() 返回的新节点不属于任何文档，不能直接 InsertEndChild()——会触发断言或崩溃，因为节点必须归属同一 XMLDocument 实例。
- 克隆后必须先用目标文档的
LinkEndChild()或InsertEndChild()显式挂载，否则节点处于“游离”状态 - 更安全的做法：
auto* cloned = doc.NewElement("copy"); cloned->SetAttribute("from", "original"); parent->InsertEndChild(cloned);—— 手动重建比克隆更可控 - 注意
DeepClone()不复制父指针，也不更新兄弟链表，所以不能在原节点被移除后再克隆——得在操作前完成 - 如果只是想改一个值并保存，直接改原节点更高效；克隆主要用于模板复用或构建新结构
tinyxml2 的节点生命周期完全绑定文档实例，所有节点指针离开所属 XMLDocument 就失效——这点容易被忽略，尤其在跨函数传递节点指针或缓存 XMLElement* 时。
