用途:该技能介绍 Qt 的 QSettings,用于持久化应用设置,包括用户偏好、窗口几何、最近文件列表和应用状态,适合需要在桌面应用中保存与恢复配置的场景。
主要能力:首次使用前设置应用元数据以确定默认存储路径,如 app.setApplicationName("MyApp")、app.setOrganizationName("MyOrg")、app.setOrganizationDomain("myorg.com")。默认位置为 Windows 注册表 HKCU\Software\MyOrg\MyApp、macOS 的 ~/Library/Preferences/com.myorg.myapp.plist、Linux 的 ~/.config/MyOrg/MyApp.ini。支持 setValue、value(可带默认值与 type 强制转换)、remove、contains、sync 等读写与删除操作;支持 beginGroup/endGroup 或斜杠分隔键进行命名空间分组。
常见用法:窗口几何通过 saveGeometry()/restoreGeometry() 与 saveState()/restoreState() 保存恢复,可正确处理多显示器;最近文件用列表键维护,限制数量并去重;设置对话框在加载时读取、保存时写回。也可用 QSettings(str(config_path), QSettings.Format.IniFormat) 指定 INI 文件,配合 QStandardPaths.writableLocation 获取平台正确路径(AppDataLocation、CacheLocation、TempLocation 等),避免硬编码 ~/.config 或 %APPDATA%。
限制与注意:settings.value() 应始终提供默认值,否则返回 None,传给期望特定类型的 Qt 方法会引发类型错误;写入通常延迟,需要时调用 sync() 强制落盘。资料未提供安装命令、收费、平台支持范围或效果保证等信息。