c++如何读取xml配置文件_tinyxml2库解析节点教程【详解】-C++-PHP中文网

TinyXML2读取XML失败主因是路径或编码问题：用绝对路径测试，确保UTF-8无BOM；LoadFile()后必须检查返回值及ErrorStr()；节点访问前须判空，遍历用NextSiblingElement("tag")而非循环调FirstChildElement()。

c++如何读取xml配置文件_tinyxml2库解析节点教程【详解】

tinyxml2 读取 XML 文件失败：常见错误和初始化检查

直接用 TinyXML2Document::LoadFile() 打不开文件，大概率不是解析逻辑问题，而是路径或编码惹的祸。Windows 下尤其容易因路径含中文、相对路径没对准、BOM 头（UTF-8 with BOM）导致 LoadFile() 返回 XML_ERROR_FILE_COULD_NOT_BE_OPENED 或静默失败。

实操建议：

先用绝对路径测试，例如 doc.LoadFile("C:\config\app.xml")，排除路径解析问题
确认文件无 BOM：用 VS Code 或 Notepad++ 查看编码，保存为 “UTF-8（无 BOM）”

检查返回值，别跳过错误判断：

auto err = doc.LoadFile("config.xml");
if (err != tinyxml2::XML_SUCCESS) {
    printf("Load failed: %s
", doc.ErrorStr());
}

获取节点内容时崩溃：空指针和文本节点陷阱

FirstChildElement() 和 FindChildByName() 类函数不保证返回非空指针，直接调 ->GetText() 必崩。更隐蔽的是：XML 中换行缩进会被解析为 XML_TEXT 节点，而非你期望的元素节点。

正确做法：

所有节点访问前加判空：auto root = doc.FirstChildElement("config"); if (!root) return;
用 FirstChildElement("port") 而非 FirstChild()->ToText()，避免误取空白文本节点
读取数值时别硬转：int port = root->FirstChildElement("port")->IntText(0); —— IntText() 内部已处理空指针和转换失败，默认返回传入的 fallback 值

遍历同名子节点：用 NextSiblingElement() 而非循环调 FirstChildElement()

写成 for (int i = 0; i FirstChildElement("item"); ... } 是典型误区——每次都会从头找第一个 item，永远取不到第二个。

标准遍历模式：

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

for (auto item = parent->FirstChildElement("item"); 
     item; 
     item = item->NextSiblingElement("item")) {
    const char* name = item->Attribute("name");
    int value = item->IntAttribute("value", -1);
}

注意：NextSiblingElement("item") 比 NextSiblingElement() 更安全，它跳过非 item 的兄弟节点（比如注释或文本），避免类型误判。

修改并保存 XML：tinyxml2 不自动美化缩进，需手动控制格式

doc.SaveFile("out.xml") 会输出紧凑格式（无换行无缩进），不利于人工查看或后续 diff。tinyxml2 默认不提供 PrettyPrint 开关，但可通过设置 XMLError 以外的参数间接控制。

关键点：

调用 doc.InsertEndChild() 或 node->LinkEndChild() 后，节点才真正属于文档树；漏掉这步会导致保存为空
如需缩进，必须在创建节点时显式插入文本节点作为换行/缩进（不推荐），或改用外部工具后处理
更实际的做法：开发阶段用 doc.Print() 输出到内存（XMLPrinter），再用正则或简单替换加缩进；生产环境保持紧凑格式，毕竟机器读取不关心美观

复杂点在于节点所有权模型——XMLNode 不是 RAII 式管理，父子关系靠链表维持，移除或重挂节点时极易断链或重复释放。一旦出现 XML_ERROR_PARSING_ELEMENT 或随机崩溃，优先检查节点是否被多次 DeleteChild() 或跨文档移动。