应直接选用tinyxml2而非tinyxml，因其是C++11友好的重写版，接口更现代、无全局状态、线程安全、默认用std::string；tinyxml已停止维护，在GCC 11+/MSVC 2019下因TiXmlString隐式转换问题编译失败。
tinyxml2 为什么比 tinyxml 更值得选
直接用 tinyxml2，别碰原始的 tinyxml（已停止维护，C++11 以上项目会卡在 TiXmlString 的隐式转换上）。tinyxml2 是重写版，接口更 C++ 化，无全局状态，线程安全，且默认用 std::string 而非自定义字符串类。
常见错误现象：tinyxml 在 GCC 11+ 或 MSVC 2019 下编译失败，报 no matching function for call to 'TiXmlString::operator const char*()' —— 这不是你代码写错了，是库本身不兼容现代标准。
- 使用场景：读取配置、解析简单结构化数据（如 UI 描述、游戏关卡）、嵌入式环境轻量 XML 处理
- 性能影响：
tinyxml2解析快约 20–30%，内存占用更低，尤其对含大量文本节点的文件 - 兼容性：支持 UTF-8（但不自动处理 BOM；若文件带 BOM，需手动跳过前 3 字节）
如何安全加载并检查 XML 文件是否有效
别一上来就 doc.LoadFile() 然后直接访问根节点——它可能返回 tinyxml2::XML_SUCCESS，但实际内容为空或格式错乱。必须检查返回值 + 根节点是否存在 + 是否为元素类型。
示例片段：
立即学习“C++免费学习笔记（深入）”；
tinyxml2::XMLDocument doc;
auto result = doc.LoadFile("config.xml");
if (result != tinyxml2::XML_SUCCESS) {
// 注意：错误信息在 doc.ErrorStr()，不是 strerror(errno)
fprintf(stderr, "XML load failed: %s\n", doc.ErrorStr());
return;
}
auto root = doc.FirstChildElement();
if (!root) {
fprintf(stderr, "XML has no root element\n");
return;
}
- 容易踩的坑：
doc.ErrorID()只有出错时才有效，成功后调用它返回未定义值 -
LoadFile()默认按系统 locale 解码，若 XML 声明里写的是encoding="UTF-8"，但文件实际是 GBK，会静默乱码——tinyxml2 不做编码转换 - 路径问题：Windows 下反斜杠需转义或用 raw string，
"C:\\cfg\\data.xml"或R"(C:\cfg\data.xml)"
提取属性和子节点时怎么避免空指针崩溃
FirstChildElement()、Attribute() 这些函数不抛异常，失败一律返回 nullptr 或空指针。直接解引用就是 crash。
正确做法是每一步都判空：
auto node = root->FirstChildElement("user");
if (!node) return; // 没这个节点
const char* name = node->Attribute("name"); // 注意返回 const char*
if (!name) name = "anonymous"; // 属性可选时设默认值
auto id_node = node->FirstChildElement("id");
if (id_node && id_node->GetText()) { // GetText() 也可能返回 nullptr
int id = atoi(id_node->GetText());
}
- 参数差异：
Attribute("attr")返回 C 字符串，Attribute("attr", &value)可以把值转成 int/float —— 但失败时不改value，必须靠返回值判断是否成功 - 常见错误现象：用
std::string(name)构造时没检查name == nullptr，导致构造崩溃 - 性能影响：频繁调用
FirstChildElement()不会重复解析，只是指针遍历，开销极小
中文文本读出来是乱码？先确认三件事
不是 tinyxml2 的锅，是编码链断了。它只负责按字节解析标签结构，不负责解码。
- XML 文件本身是否保存为 UTF-8（无 BOM）？编辑器里看“编码”选项，别用记事本存成 UTF-8 with BOM
- XML 声明是否明确写了
？没写时 tinyxml2 默认当 UTF-8，但某些旧工具生成的文件其实是 GBK - 你的终端或调试器是否支持 UTF-8 显示？Linux/macOS 一般没问题；Windows 控制台默认 GBK，
printf("%s", text)会显示为乱码 —— 改用SetConsoleOutputCP(CP_UTF8)（Windows）或输出到文件再查看
如果必须处理 GBK XML，得自己用 iconv 或 Windows API 先转成 UTF-8 再喂给 tinyxml2::XMLDocument::Parse()，而不是 LoadFile()。
最常被忽略的一点：tinyxml2 对换行符、空白字符不做标准化处理。XML 中的
、
、 会原样保留在 GetText() 结果里，直接用来比较或拼接时容易出逻辑 bug。
