桌面应用 / 系统课时

用 QSettings 保存用户配置

用 QSettings 保存用户配置

桌面应用通常需要记住用户上次选择的主题、窗口大小和功能偏好。QSettings 提供了一套跨平台配置存储机制,让应用可以保存和恢复简单设置,而无需自行设计配置文件格式。

学习目标

  • 理解 QSettings 的键值配置模型
  • 使用 QSettings 保存和读取用户偏好
  • 在应用启动和关闭阶段恢复窗口状态

认识 QSettings 的工作方式

QSettings 使用键值对保存配置。应用只需要定义稳定的键名,例如 window/size 或 theme,Qt 会负责选择合适的存储方式。

不同平台下,配置可能保存到系统注册表、配置文件或系统推荐位置。开发者不需要直接操作这些底层存储。

QSettings 配置保存与恢复流程图

保存和读取简单配置

下面示例保存主题选项,并在启动时读取。如果配置不存在,使用默认值。

cpp
#include <QCoreApplication>
#include <QSettings>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);

    QSettings settings("ExampleCompany", "NoteApp");

    // 用户第一次运行时使用默认主题
    QString theme = settings.value("ui/theme", "light").toString();

    qDebug() << "Current theme:" << theme;

    settings.setValue("ui/theme", "dark");
    return 0;
}

预期输出

text
Current theme: "light"

第一次运行时没有配置,因此读取默认值。再次运行时会读取之前保存的值。

保存窗口状态

窗口类应用经常需要保存大小、位置和最大化状态。通常在关闭窗口时写入配置,在创建窗口时恢复。

例如:

cpp
#include <QSettings>
#include <QMainWindow>

void saveWindowState(QMainWindow *window)
{
    QSettings settings("ExampleCompany", "NoteApp");
    settings.setValue("window/geometry", window->saveGeometry());
}

void restoreWindowState(QMainWindow *window)
{
    QSettings settings("ExampleCompany", "NoteApp");
    QByteArray geometry = settings.value("window/geometry").toByteArray();

    if (!geometry.isEmpty()) {
        window->restoreGeometry(geometry);
    }
}

预期结果

text
应用重新启动后,窗口恢复到上一次关闭时的位置和大小。

这里保存的是 Qt 序列化后的窗口状态数据,不需要开发者手动记录坐标。

配置设计中的注意事项

配置键名需要长期稳定。一旦发布版本后修改键名,旧用户的配置就无法继续使用。

对于简单偏好设置,QSettings 足够方便;对于大量结构化数据,例如历史记录、业务数据或复杂对象,不建议使用 QSettings,应考虑数据库或专用配置文件。

还需要注意不要保存敏感信息,例如密码或访问令牌。QSettings 主要用于用户体验相关配置,而不是安全存储方案。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 QSettings 保存用户配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通