TinyXML2是轻量易集成的C++ XML库，需检查LoadFile返回值及ErrorStr()定位解析失败原因；获取属性和文本前必须判空；新建节点须用NewElement()并显式插入；遍历同名子节点时循环起点即首节点，NextSiblingElement("tag")确保类型匹配。
用 C++ 操作 XML 文件，TinyXML2 是目前最轻量、最易集成的选择之一；它不依赖外部库、头文件即用，适合嵌入式或中小型项目。但直接上手容易踩坑：节点查找失败、中文乱码、属性读取为空、子节点遍历遗漏——这些问题大多出在命名空间忽略、编码处理不当、或 XMLElement 与 XMLNode 类型混淆上。
怎么加载并检查 XML 文件是否解析成功
加载失败往往静默发生，doc.LoadFile() 返回 tinyxml2::XML_SUCCESS 才算真正成功；否则需通过 doc.ErrorID() 和 doc.ErrorStr() 查错，而不是只看指针是否为空。
-
doc.LoadFile("config.xml")返回非零值时，doc.ErrorStr()可能返回"Failed to open file"（路径错误）或"XML parse error"（格式非法） - 确保文件以 UTF-8 无 BOM 编码保存，否则含中文时
doc.FirstChildElement("用户")可能返回nullptr - 若从内存字符串加载，用
doc.Parse(buffer)，注意buffer必须以\0结尾，且不能是临时std::string.c_str()（生命周期问题）
怎么安全获取节点内容和属性值
XMLElement::Attribute() 和 XMLElement::GetText() 都可能返回 nullptr，必须判空；且 Attribute() 不支持默认值，需手动补全逻辑。
tinyxml2::XMLDocument doc;
doc.LoadFile("data.xml");
auto root = doc.FirstChildElement("root");
if (root) {
const char* ver = root->Attribute("version"); // 可能为 nullptr
std::string version = ver ? ver : "1.0"; // 手动设默认值
auto user = root->FirstChildElement("user");
if (user) {
const char* name = user->Attribute("name");
const char* text = user->GetText(); // 注意：只取直接子文本，不含子元素内容
if (name && text) {
printf("User: %s, desc: %s\n", name, text);
}
}}
立即学习“C++免费学习笔记（深入）”；
怎么创建新节点并插入到指定位置
新建节点必须用 XMLDocument 实例的工厂方法（如 NewElement()），不能用 new XMLElement；插入后需确认父节点未被销毁（尤其在函数局部作用域中）。
-
doc.NewElement("item")创建的节点尚未挂载，必须显式调用parent->InsertEndChild()或InsertFirstChild() - 若要插入带文本内容的节点，先
NewElement()，再NewText()，最后LinkEndChild()（不是InsertEndChild()） - 插入后调用
doc.Print()可输出到控制台验证结构，避免“以为插进去了其实没生效”
怎么遍历所有同名子节点而不漏掉第一个
新手常误用 FirstChildElement("item") + NextSiblingElement("item") 却忘记循环起点本身也是目标节点，导致跳过首项。
auto item = root->FirstChildElement("item");
while (item) {
const char* id = item->Attribute("id");
printf("Found item id=%s\n", id ? id : "null");
item = item->NextSiblingElement("item"); // 注意参数传 "item"，否则会跨类型匹配
}
关键点：循环变量初始值就是第一个匹配节点，每次迭代移动到下一个同名兄弟节点；若传空字符串或其它标签名，NextSiblingElement() 会返回 nullptr 或错位节点。
真正麻烦的是混合文本与元素的结构（比如 Hello world.doc.SetUserData() 并配合 XMLNode::ToText() 判断类型——这点多数文档不提，但实际解析 HTML 片段或富文本配置时绕不开。
