FirstChildElement()返回nullptr主因是XML中换行缩进被解析为XMLText节点，而该函数只查找元素节点；应始终用FirstChildElement("tag")跳过非元素节点，而非FirstChild()->ToElement()。
tinyxml2::XMLNode::FirstChildElement() 返回空指针？
多数人卡在这一步：调用 FirstChildElement("xxx") 后得到 nullptr，不是 XML 结构写错了，就是没跳过文本节点。TinyXML2 默认把换行、缩进都当作 XMLText 节点，而 FirstChildElement() 只找元素节点（XMLElement），不找文本或注释。
解决方法很简单：用带名称的版本，跳过非元素节点：
auto root = doc.FirstChildElement("config");
if (!root) return; // 根元素不存在
auto item = root->FirstChildElement("item"); // ✅ 正确：直接找名为 "item" 的子元素
// ❌ 错误写法（容易为空）：
// auto item = root->FirstChild()->ToElement(); // 可能是换行文本节点，ToElement() 失败返回 nullptr
- 永远优先用
FirstChildElement("TagName")，而不是先FirstChild()再ToElement() - 如果不确定子元素是否一定存在，必须判空；
nullptr解引用会崩溃 - 元素名区分大小写，
"Item"和"item"是不同节点
读取属性值时 getAttribute() 返回空字符串？
XMLElement::Attribute() 是安全读取属性的首选，它在属性不存在时返回 nullptr，不是空字符串 —— 很多人误用 Value() 或直接转 std::string 导致崩溃或逻辑错误。
auto elem = doc.FirstChildElement("user");
if (elem) {
const char* id = elem->Attribute("id"); // ✅ 安全：不存在时返回 nullptr
const char* name = elem->Attribute("name");
if (id && name) {
std::string uid(id); // 只有非空才构造
std::string uname(name);
}
}
-
Attribute("attr")返回const char*，不是std::string；别直接传给需要std::string的函数而不判空 - 想获取默认值？自己封装一层：
std::string attr = std::string(elem->Attribute("type") ?: "default") - 属性名也是大小写敏感，
"ID"≠"id"
循环遍历同名子元素并读取各自属性
常见需求：XML 中多个 <param>，每个带 name 和 value 属性。不能只调一次 FirstChildElement()，得用 NextSiblingElement() 链式遍历。
立即学习“C++免费学习笔记（深入）”；
for (auto param = root->FirstChildElement("param");
param;
param = param->NextSiblingElement("param")) {
const char* name = param->Attribute("name");
const char* value = param->Attribute("value");
if (name && value) {
params.emplace_back(name, value); // 存入 map 或 vector
}
}
-
NextSiblingElement("param")保证只找下一个同名兄弟元素，跳过中间的文本/注释/其他标签 - 如果省略参数（写成
NextSiblingElement()），它会返回任意类型的下一个兄弟节点，再ToElement()可能又为nullptr - 循环体内部仍需检查
Attribute()返回值，属性缺失很常见
中文属性值乱码或读不出来？
TinyXML2 默认按 UTF-8 解析，但 Windows 上用记事本保存的 XML 常是 GBK/ANSI 编码，导致 Attribute() 返回的 const char* 字节序列无法被正确解释为中文。
- 最稳妥做法：用支持编码检测的编辑器（VS Code、Notepad++）将 XML 文件另存为 UTF-8（无 BOM）
- 代码里不推荐手动转码；TinyXML2 没内置 GBK 支持，硬解容易出错
- 如果必须处理 GBK 文件，先用系统 API（如 Windows 的
MultiByteToWideChar）转成 UTF-16，再转 UTF-8 字符串喂给 TinyXML2 的内存解析接口（LoadFile()不支持传入编码）
属性读取本身没有“自动编码转换”逻辑 —— 它只是原样返回文件里的字节。乱码本质是源文件编码和解析预期不一致，不是 API 用错了。
