TinyXML2加载XML文件失败最常见原因是路径错误，因LoadFile()以当前工作目录而非可执行目录为基准，需用std::filesystem::current_path()确认路径，优先使用绝对路径测试，并在调用后检查返回值是否为XML_SUCCESS，否则通过ErrorStr()定位具体错误。
加载XML文件时遇到TinyXML2::XMLDocument::LoadFile()返回XML_ERROR_FILE_NOT_FOUND
路径写错是最常见原因，TinyXML2不自动处理相对路径的上下文——它始终以当前工作目录（不是可执行文件所在目录）为基准。调试时先用std::filesystem::current_path()确认当前目录，再检查路径是否拼写正确、大小写是否匹配（尤其在Linux/macOS上）。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 优先使用绝对路径测试，比如
doc.LoadFile("/home/user/config.xml")，排除路径歧义 - 若必须用相对路径，构造前显式拼接：
std::string path = std::string(argv[0]) + "/../config.xml"（需配合std::filesystem::path(argv[0]).parent_path()更可靠） - 调用
LoadFile()后务必检查返回值：if (doc.LoadFile("config.xml") != tinyxml2::XML_SUCCESS) { /* 打印doc.ErrorStr() */ }
读取节点内容时XMLElement::Text()返回空指针
这通常不是数据缺失，而是节点结构理解有误：Text()只获取直接文本子节点（即<name>Alice</name>中的Alice），如果节点内嵌了其他元素、注释或空白符，Text()就返回nullptr。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
QueryIntText()、QueryDoubleText()等类型安全方法替代，它们内部会跳过空白和注释 - 若需原始文本且节点可能含混合内容，改用
GetText()（返回const char*，但要注意生命周期） - 打印完整结构辅助诊断：
doc.Print();查看实际DOM树，确认目标节点是否真有纯文本子节点
解析属性值时XMLAttribute::Value()崩溃或返回乱码
根本原因是TinyXML2默认按UTF-8编码解析，而配置文件若保存为GBK/UTF-16等编码，会导致属性字符串被截断或解码失败，后续Value()访问非法内存。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 强制用UTF-8保存XML文件（VS Code/Notepad++中选择“编码→UTF-8无BOM”）
- 若无法修改文件编码，加载前手动转码：用
std::iconv或boost::locale将文件内容转UTF-8后再传给Parse() - 属性名区分大小写，
FindAttribute("PORT")和FindAttribute("port")结果不同，检查XML源码中的实际拼写
多级嵌套节点遍历时FirstChildElement()链式调用容易出错
每层调用都可能返回nullptr，直接链式调用如root->FirstChildElement("server")->FirstChildElement("port")->IntText()会在任一环节为空时导致段错误。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 逐层判空：
auto server = root->FirstChildElement("server"); if (!server) return; auto port = server->FirstChildElement("port"); if (!port) return; - 封装安全访问函数，例如：
template<typename t> T SafeQuery(const tinyxml2::XMLElement* e, const char* name, T def) { return e && e->FirstChildElement(name) ? e->FirstChildElement(name)->QueryIntText() : def; }</typename> - 避免重复查找同名节点——先缓存中间节点指针，而非反复调用
FirstChildElement()
TinyXML2本身不管理内存生命周期，所有XMLElement、XMLAttribute指针均随XMLDocument对象销毁而失效，别在doc析构后还持有或访问这些指针。
