tinyxml2中设置节点attribute应使用SetAttribute()等方法而非LinkEndChild()；需注意大小写敏感、编码、路径权限及错误处理。
tinyxml2 里怎么设置节点的 attribute 而不是子节点
很多人误用 TiXmlElement::LinkEndChild() 往元素里塞 TiXmlAttribute，结果 XML 文件里啥也没写出来——因为 TiXmlAttribute 不是节点，不能当子节点加。正确做法是调用 SetAttribute() 或 SetDoubleAttribute() 等系列方法。
常见错误现象：doc.FirstChildElement("config")->FirstChildElement("timeout")->LinkEndChild(new TiXmlAttribute("unit", "ms"))，运行后完全没效果，还可能引发崩溃。
-
SetAttribute("key", "value")最常用，字符串值自动转义（比如&→&） - 数值类型优先用
SetDoubleAttribute("port", 8080.0)，避免字符串转换精度丢失 - 布尔值别手写
"true"/"false"，tinyxml2 不识别，直接用SetBoolAttribute("debug", true) - 如果 key 已存在，
SetAttribute()会覆盖旧值；想保留原值需先FirstAttribute()遍历检查
保存配置时如何避免覆盖已有 XML 结构
直接 doc.SaveFile("config.xml") 看似简单，但若原始 XML 有注释、CDATA、格式缩进或未声明的命名空间，tinyxml2 默认会全部丢弃——它只认 DOM 结构，不保留解析时的“装饰性”内容。
使用场景：你改了一个 max_connections 属性，但不想让团队其他成员写的 注释消失。
立即学习“C++免费学习笔记（深入）”；
- tinyxml2 没有“只更新 attribute”的原子操作，必须先
LoadFile()全量加载，再定位修改，最后全量保存 - 若原始文件含 BOM（如 UTF-8 with BOM），
LoadFile()可能失败，需用LoadFile(const char*, TiXmlEncoding)显式指定TIXML_ENCODING_UTF8 - 保存前调用
doc.SetIndent(" ")可控制缩进，但无法还原原始换行位置；别指望和手写 XML 格式一致 - 不要在多线程里共用同一个
TiXmlDocument实例，SaveFile()非线程安全
读取配置时 attribute 名大小写敏感吗
敏感。tinyxml2 默认严格区分大小写，GetAttribute("Timeout") 和 GetAttribute("timeout") 是两个不同 key。
这在跨平台协作时容易出问题：Windows 下测试用的 XML 是小写，Linux CI 里跑的脚本生成的是驼峰，程序直接读不到值，返回空指针或默认值也不报错。
- 没有内置的 case-insensitive 查找，必须自己遍历
FirstAttribute()链表比对stricmp() - 建议统一约定：所有配置项 key 全小写（如
"log_level"），文档和代码保持一致 - 用
QueryIntAttribute()时，如果属性值不是合法整数（如空字符串、"auto"），函数返回TIXML_SUCCESS但目标变量不变——容易埋下静默错误 - 检查返回值！
if (elem->QueryIntAttribute("retry", &val) != TIXML_SUCCESS) val = 3;
为什么修改完 attribute 后 SaveFile() 报错“Failed to write file”
大概率是路径权限或目录不存在，而不是 XML 内容问题。tinyxml2 的 SaveFile() 底层调用系统 fopen(..., "w")，不会自动创建父目录。
典型表现：开发机上好好的，部署到 Docker 容器里就失败；或者配置路径写成 "./etc/config.xml"，但当前工作目录是 /app，而 /app/etc 目录压根没被 mkdir -p 过。
- 先用
std::filesystem::create_directories()（C++17）确保路径存在，再调用SaveFile() - 不要依赖相对路径，生产环境建议用绝对路径 + 配置项（如
config_dir="/var/lib/myapp"）拼接 - Windows 下注意反斜杠转义：写
"C:\ProgramData\MyApp\config.xml"，别用"C:ProgramDataMyAppconfig.xml"（编译报错） - 保存失败时，
SaveFile()返回 false，但不提供 errno；需自己用std::ofstream打开测试写权限
attribute 操作看着简单，实际卡点都在路径、编码、大小写和错误处理这些边缘位置。尤其多人维护时，一个没加 QueryXXXAttribute() 返回值检查，就能让配置失效得毫无征兆。
