loadfile()失败应检查返回值是否为xml_success，再用errorid()和errorname()定位错误；注意路径、utf-8无bom编码、xml语法、大小写敏感、firstchildelement()非递归等常见问题。
tinyxml2 读取 XML 文件失败，TinyXml2::XMLDocument::LoadFile() 返回非零值怎么办
直接检查返回值是 tinyxml2::XML_SUCCESS 还是错误码，别只看指针是否为空——LoadFile() 成功时返回 0，失败返回具体错误码（如 XML_ERROR_FILE_NOT_FOUND、XML_ERROR_PARSING_ELEMENT）。常见原因是路径写错、文件编码不是 UTF-8（含 BOM）、或 XML 格式有语法错误（比如未闭合标签）。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
doc.ErrorID()获取错误类型，再查doc.ErrorName()得到可读字符串，比猜快得多 - 路径尽量用绝对路径测试，排除相对路径工作目录不一致问题；Windows 下注意反斜杠要双写或用正斜杠：
"./config.xml" - 如果文件含中文，确认是 UTF-8 无 BOM；用 VS Code 或 Notepad++ 查看并转换编码，BOM 会导致解析直接失败
- 临时把 XML 内容用
doc.Parse()加载字符串调试，能绕过文件 I/O 干扰，快速定位是内容问题还是路径问题
用 TinyXml2::XMLNode::FirstChildElement() 找不到节点？
它只找**直接子元素**，不递归搜索，且区分大小写、忽略空白文本节点。很多人以为它像 XPath 的 //name，结果遍历一层就停了。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确认目标元素确实是当前节点的**直系子元素**；如果不是，得用
FirstChildElement()链式调用，或自己写递归遍历 - XML 中换行缩进产生的空格和换行会被当作
XMLElement同级的XMLText节点，所以FirstChild()可能返回的是空白文本，而不是你想要的元素——务必用FirstChildElement()，别用FirstChild() - 元素名严格匹配：写成
"Config"就找不到<config></config>；建议统一小写命名，避免歧义 - 加个空检查再取属性：
auto elem = root->FirstChildElement("server"); if (elem) { const char* port = elem->Attribute("port"); }
XMLAttribute::Value() 返回空指针，但属性明明写了
典型表现是 elem->Attribute("timeout") 返回 nullptr，但打开 XML 看属性确实存在。最常见两个原因：拼写错误（含空格/大小写）、属性值为空字符串（timeout=""），而 Attribute() 对空值也返回 nullptr。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
elem->FirstAttribute()遍历所有属性，打印名字和值，验证实际解析出的属性名是否和你代码里写的完全一致 - 不要依赖“属性一定存在”，总是先判空再用：
const char* val = elem->Attribute("mode"); if (val) { /* safe use */ } - 如果允许空值语义，改用
elem->QueryIntAttribute("count", &out)这类带默认值的接口，它在属性缺失或格式错误时返回错误码，不会崩溃 - 注意
Attribute()返回的是const char*，指向内部缓冲区，文档生命周期内有效；别存指针长期使用
tinyxml2 解析后内存泄漏？XMLDocument 需要手动清理吗
不需要显式释放节点内存——XMLDocument 析构时自动回收全部子节点。但有两个关键点容易漏：全局/静态 XMLDocument 实例可能拖到程序结束才释放；频繁创建销毁文档时，内部有内存池优化，但若混用不同文档的节点（比如把 A 文档的节点 InsertEndChild() 到 B 文档），会引发未定义行为。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 让
XMLDocument对象保持局部作用域，用完即析构，是最安全做法 - 避免跨文档移动节点：所有操作必须在同一个
XMLDocument实例内完成；如需复制，用Clone()方法 - 如果解析大量小 XML，注意
XMLDocument默认启用内存池（SetUserData()不影响），一般不用干预；但若嵌入式环境极度受限，可构造时传false关闭：XMLDocument doc(false) - 用 ASan 或 Valgrind 测试时，别被 tinyxml2 内部缓存误报干扰——重点看你自己 new 的对象是否匹配 delete
事情说清了就结束
