常见错误包括路径/大小写不匹配、未检查中间节点空指针、整数类型截断、UTF-8编码与环境错位、保存路径权限不足或相对路径不可靠；需逐层判空、显式类型转换、确认UTF-8编码、使用绝对可写路径并验证文件操作结果。
tinyxml2 读取 XML 配置文件时，FirstChildElement() 返回空指针怎么办
常见错误是路径写错、大小写不匹配或 XML 根节点名和代码预期不一致。tinyxml2 不报错也不提示缺失元素，直接返回 nullptr，容易导致后续 Text() 或 IntAttribute() 段错误。
- 先用
document.ErrorID()检查是否加载失败（比如文件不存在、编码非 UTF-8） -
FirstChildElement("Config")中的"Config"必须和 XML 文件最外层标签完全一致，包括大小写 - 如果配置项嵌套多层，别连用多次
FirstChildElement()而不检查中间返回值；每一步都该判空 - 示例：
auto root = doc.FirstChildElement("AppConfig"); if (!root) { /* 处理根节点缺失 */ } auto dbNode = root->FirstChildElement("Database"); if (!dbNode) { /* 不要直接调 dbNode->FirstChildElement(...) */ }
用 SetAttribute() 写入整数却存成乱码或负值
tinyxml2 的 SetAttribute() 只接受 const char* 或整型（int、double），但底层会调用 XMLUtil::ToStr() 转字符串。问题常出在类型隐式转换或平台字长差异上。
- 避免对
size_t、long long直接调SetAttribute("size", my_size)—— 它会被截断为int，64 位系统上尤其危险 - 统一转成
int或long long后用std::to_string()+c_str()显式传字符串 - 写入浮点数时注意精度丢失：默认只保留 6 位有效数字，需手动格式化（如
std::fixed ） - 示例：
node->SetAttribute("timeout_ms", static_cast<int>(cfg.timeout)); // 安全
保存 XML 后中文显示为问号或乱码
tinyxml2 默认以 UTF-8 编码读写，但 Windows 控制台/记事本常默认用 GBK 打开，且部分编辑器不会识别 BOM。不是 tinyxml2 本身的问题，而是环境与编码预期错位。
- 确保源 XML 文件本身就是 UTF-8 编码（无 BOM 更稳妥，tinyxml2 对 BOM 支持有限）
- 用
doc.SaveFile("config.xml")保存后，用 VS Code 或 Notepad++ 确认文件确实是 UTF-8；Windows 记事本另存时选“UTF-8”而非“ANSI” - 如果必须兼容 GBK 环境，不要强行改 tinyxml2，而应在读写前后用 iconv 或 Windows API（
MultiByteToWideChar）做转换 - tinyxml2 不支持设置输出编码，
XMLPrinter输出也是 UTF-8，硬改源码得不偿失
程序重启后配置没生效，SaveFile() 却没报错
最常见原因是路径权限不足或写入了错误位置 —— 尤其在 Windows 上，默认安装目录（如 Program Files）禁止普通用户写入，但 SaveFile() 返回 TIXML_SUCCESS 并不等于磁盘写入成功。
立即学习“C++免费学习笔记（深入）”；
- 永远检查
doc.SaveFile(path.c_str()) == TIXML_SUCCESS，但更要确认path是可写的用户目录（如GetFolderPath(FOLDERID_RoamingAppData)） - 不要用相对路径如
"config.xml"，它依赖当前工作目录（CWD），而 CWD 在双击启动、服务启动、IDE 启动时完全不同 - 建议用绝对路径 + 用户数据目录，例如：
std::string configPath = GetAppDataPath() + "/myapp/config.xml";
- 写入前可先
std::ofstream test(configPath, std::ios::out); if (!test) { /* 权限失败 */ }
配置持久化真正难的不是读写语法，而是路径可靠性、编码一致性、以及把“写成功”和“磁盘落盘成功”当成两件事来验证。tinyxml2 很轻量，但也因此不帮你兜底这些系统层问题。
