用tinyxml2读取XML节点最省事：直接包含tinyxml2.h和tinyxml2.cpp，用XMLDocument::LoadFile()加载，FirstChildElement()查找节点，QueryIntAttribute()安全取属性，每层判空防崩溃，缺失字段需手动封装默认值逻辑，UTF-8编码是前提。
用 tinyxml2 读取 XML 节点最省事
直接上结论：别自己手写解析器，用 tinyxml2 —— 它头文件只有 1 个、不依赖外部库、支持 C++11、读写都轻量。Windows/Linux/macOS 全平台可用，编译时加 -std=c++11 就行。
常见错误是把 TinyXml2（旧版）和 tinyxml2（新版）搞混，后者 GitHub 仓库名是 leethomason/tinyxml2，头文件名是 tinyxml2.h，不是 tinyxml.h。
实操建议：
- 下载
tinyxml2.h和tinyxml2.cpp放进项目目录，直接#include "tinyxml2.h" - 用
tinyxml2::XMLDocument加载文件或字符串，LoadFile()返回非零值说明失败 - 节点查找用
FirstChildElement("TagName")，不是FirstChild()—— 后者可能返回文本节点或注释，容易空指针崩溃 - 获取属性值推荐
QueryIntAttribute("version", &val)，比Attribute("version")更安全（避免空指针或类型转换异常）
读取嵌套节点时怎么避免段错误
XML 层级深了，链式调用 FirstChildElement()->FirstChildElement()->...->GetText() 一旦中间某个节点不存在，立刻崩。必须每层检查非空。
立即学习“C++免费学习笔记（深入）”；
正确写法不是“一口气写完”，而是分步断言：
auto* root = doc.FirstChildElement("config");
if (!root) return; // 没有 config 根节点
auto* db = root->FirstChildElement("database");
if (!db) return;
auto* host = db->FirstChildElement("host");
if (host && host->GetText()) {
std::string host_str = host->GetText();
}
注意：GetText() 返回的是 const char*，指向内部缓冲区，不要存指针长期使用；需要保存就构造 std::string。
容易踩的坑：
抓取指定 GitHub用户的 Stars 项目，生成标准化中文 Markdown 报告。用户提及「分析 GitHub stars」「导出收藏项目」「汇总 GitHub 星标」「生成 stars 报告」或粘贴含 ?tab=stars 的链接时触发。执行通过 bash...
- 误用
NextSiblingElement()却没判空，循环里直接解引用 → 段错误 - 用
FirstChild()获取子节点后，没用->ToElement()就强转 → 返回 null - XML 中有空白换行，
FirstChild()可能拿到的是XMLText节点，不是XMLElement
解析配置文件时如何处理缺失字段的默认值
真实配置文件经常缺某些可选字段，比如 <timeout>30</timeout> 没写，就得用默认值 30。tinyxml2 本身不提供默认值机制，得自己封装一层。
推荐写个辅助函数：
int GetIntValue(const tinyxml2::XMLElement* elem, const char* name, int def = 0) {
auto* child = elem ? elem->FirstChildElement(name) : nullptr;
if (child && child->GetText()) {
int val;
if (child->QueryIntText(&val) == tinyxml2::XML_SUCCESS) return val;
}
return def;
}
// 使用：int port = GetIntValue(root, "port", 8080);
关键点：
- 用
QueryIntText()而不是FirstChildElement()->IntText()，前者失败返回错误码，后者崩溃 - 不要在
FirstChildElement()后直接调IntText()，它不检查节点是否为元素类型 - 如果字段允许为空字符串但语义是“未设置”，需额外判断
GetText() != nullptr && strlen(...) > 0
中文路径或 UTF-8 内容乱码怎么办
tinyxml2 默认按 UTF-8 解析，只要你的 XML 文件保存为 UTF-8（无 BOM），且内容里中文是合法 UTF-8 字节序列，就不会乱码。问题通常出在文件读取环节。
Windows 下用 LoadFile() 读含中文路径的文件会失败（tinyxml2::XML_ERROR_FILE_COULD_NOT_BE_OPENED），因为 Windows API 的 fopen 不支持 UTF-8 路径。
解决办法：
- Linux/macOS 直接用
LoadFile("配置.xml")没问题 - Windows 下先用
std::ifstream以二进制方式读入内存，再用Parse()解析字节流 - 确保 XML 声明里写了编码，例如
<?xml version="1.0" encoding="UTF-8"?>—— 虽然 tinyxml2 实际上忽略它，但其他工具可能依赖 - 如果内容里有中文但显示为问号，大概率是终端/IDE 控制台没设 UTF-8 编码，不是解析问题
最常被忽略的一点：tinyxml2 不做字符编码转换，它只认 UTF-8 字节流。如果你的源文件是 GBK，必须先转成 UTF-8 再喂给它，否则 GetText() 返回的就是乱码字节。
