QSettings默认构造在不同平台行为不一致，应显式指定QSettings::IniFormat和QSettings::UserScope以统一使用INI文件并避免权限问题；键名含斜杠仅作逻辑分组，读取需注意重名；value()返回QVariant，须用contains()或带默认值重载确保安全；修改后须调用sync()落盘，否则可能丢失数据。
QSettings 构造时指定格式和路径容易出错
默认构造的 QSettings 在不同平台行为不一致：Windows 写注册表，macOS 写 plist，Linux 写 ini 文件。如果想统一用 ini 文件（便于调试、跨平台查看），必须显式指定格式和路径：
- 用
QSettings::IniFormat+QSettings::UserScope避免权限问题，路径自动落在用户目录下 - 不要传空字符串或相对路径给构造函数，否则可能 fallback 到系统默认位置，导致配置“写进去了却读不到”
- 推荐写法：
QSettings settings(QSettings::IniFormat, QSettings::UserScope, "MyCompany", "MyApp");
保存值时 key 名带斜杠会被当成分组，但读取时不强制要求
QSettings 支持类似 ini 的分组语法，比如 settings.setValue("network/timeout", 5000); 会写成 [network]\ntimeout=5000。但注意：
- 分组只是逻辑组织，不是路径层级——
setValue("a/b/c", 1)和setValue("a/b/c/d", 2)不会自动创建嵌套结构，只是普通键名 - 读取时不用加前缀分组名：
settings.value("timeout").toInt()就能读到，前提是没重名；有重名时才需用完整 key，如"network/timeout" - 避免用点号（
.）或空格在 key 里，某些格式（如 registry）可能解析异常
读取值必须检查是否包含有效数据，不能直接强转
QSettings::value() 总是返回 QVariant，即使 key 不存在也返回空 QVariant。直接调 .toInt() 或 .toString() 会得到默认值（0、空字符串等），掩盖“配置未设置”的问题：
- 正确做法是先用
contains("key")判断是否存在，再取值 - 或者用带默认值的重载：
settings.value("theme", "light").toString()，这样既安全又简洁 - 对布尔值尤其要注意：
value("auto_save").toBool()对空QVariant返回false，可能误判为用户关掉了功能
QSettings 不是实时同步的，修改后要主动 sync() 才写入磁盘
默认情况下，QSettings 会缓存修改，直到对象析构或显式调用 sync() 才真正落盘。这意味着：
立即学习“C++免费学习笔记（深入）”；
- 程序崩溃或被 kill 时，最近几次
setValue()可能丢失 - 多进程同时访问同一配置文件时，不
sync()就读不到对方刚写的值 - 一般建议在关键配置变更后立刻
settings.sync()；如果频繁写，可考虑批量操作后统一 sync，避免 I/O 拖慢响应
sync() 失败不会抛异常，要用 status() 检查，常见错误是磁盘满或权限不足，返回 QSettings::AccessError。
