前言
QSettings 是 Qt 提供的一个非常有用的类，用于读取和保存应用程序的设置或配置。它可以将数据保存在不同的后端存储中，例如注册表（在 Windows 上）、INI 文件、或特定平台的本地存储。
正文
在说QSettings之前先了解了解什么是配置文件
配置文件是存储应用程序或系统配置数据的文件，用于定义程序的各种设置，如参数、选项、路径等。配置文件可以使应用程序更加灵活，允许用户和管理员根据需要调整程序的行为，而不需要重新编译或修改源代码。
配置文件的格式
配置文件的格式有多种，常见的格式包括：
-
INI 文件:
- 具有简单的键值对结构，通常按部分（Section）组织。
- 每个部分用方括号
[section]包围，内部是键值对key=value，类似于哈希表。 - 例如：
[General] language=en theme=dark[Paths] log_dir=/var/log/app
-
XML 文件:
- 使用标记语言定义层次结构的配置。
- 结构化且可以定义复杂的配置层次。
- 例如：
<configuration><general><language>en</language><theme>dark</theme></general><paths><log_dir>/var/log/app</log_dir></paths> </configuration>
-
JSON 文件:
- 使用键值对的嵌套结构，支持复杂的配置结构。
- 适合表示嵌套和数组等复杂数据。
- 例如：
{"general": {"language": "en","theme": "dark"},"paths": {"log_dir": "/var/log/app"} }
-
YAML 文件:
- 具有良好的可读性，适合人类阅读和编辑。
- 使用缩进表示层次结构。
- 例如：
general:language: entheme: darkpaths:log_dir: /var/log/app
配置文件中通常放置的信息
配置文件中一般包含以下信息：
- 应用程序设置: 如语言、主题、启动选项等。
- 文件路径: 如日志文件路径、数据存储路径、临时文件路径等。
- 网络配置: 如服务器地址、端口号、API 密钥等。
- 用户偏好: 如用户界面设置、默认行为等。
- 环境变量: 如操作系统特定的路径或变量。
- 安全配置: 如用户认证信息、加密密钥（通常需要额外保护）。
QSettings基本用法
QSettings 的使用非常简单，它可以读写各种类型的数据，如字符串、整数、布尔值、列表、字典等。
1. 初始化 QSettings 对象
你可以通过指定应用程序名和组织名来创建一个 QSettings 对象：
QSettings settings("MyCompany", "MyApp");
在这种情况下，Qt 会根据操作系统选择合适的存储位置。例如：
- 在 Windows 上，它会使用注册表。
- 在 macOS 上，它会使用
.plist文件。 - 在 Linux 上，它会使用
.ini文件。
你也可以指定一个文件路径来存储设置(更常用)：
//path可以替换成路径
QSettings settings(path, QSettings::IniFormat);
//比如，默认与exe同级目录，也可以在pro文件中指定路径
QSettings settings("config.ini", QSettings::IniFormat);
2. 设置配置文件中文显示
//设置配置文件中的中文显示
settings.setIniCodec("utf-8")
2. 写入设置
//setValue(组名/key,value)
settings.setValue("username", "user123");
settings.setValue("window/width", 1024);
settings.setValue("window/height", 768);
这些设置会自动保存在指定的存储位置。
3. 读取设置
读取设置时，可以提供一个默认值，以防指定的键不存在：
//value返回一个QVariant类型的值，需要转换成自己所需要的类型
QString username = settings.value("username", "defaultUser").toString();
int width = settings.value("window/width", 800).toInt();
int height = settings.value("window/height", 600).toInt();
4. 检查是否存在某个键
你可以使用 contains() 方法来检查某个键是否存在：
if (settings.contains("username")) {// 键存在
}
5. 删除设置
要删除某个设置，使用 remove() 方法：
settings.remove("username");
6. 读取所有键
你可以通过 allKeys() 获取所有的键：
//allKeys()返回一个包含所有组/key的QStringList的列表
QStringList keys = settings.allKeys();
for (const QString &key : keys) {qDebug() << key << ": " << settings.value(key).toString();
}
例子：存储和读取窗口大小
以下是一个简单的示例，演示如何使用 QSettings 保存和恢复窗口的大小和位置：
#include <QApplication>
#include <QMainWindow>
#include <QSettings>int main(int argc, char *argv[])
{QApplication app(argc, argv);QMainWindow window;// 创建 QSettings 对象QSettings settings("MyCompany", "MyApp");// 读取窗口的大小和位置window.resize(settings.value("window/size", QSize(400, 400)).toSize());window.move(settings.value("window/pos", QPoint(200, 200)).toPoint());window.show();int result = app.exec();// 在应用程序退出时保存窗口的大小和位置settings.setValue("window/size", window.size());settings.setValue("window/pos", window.pos());return result;
}
在这个示例中，窗口的大小和位置会在每次启动应用程序时恢复，并在关闭应用程序时保存。
高级用法
1. 分层结构
QSettings 支持分层的键结构，例如：
settings.setValue("mainwindow/geometry", someGeometry);
settings.setValue("mainwindow/state", someState);
2. 使用组（Groups）
你可以使用 beginGroup() 和 endGroup() 方法来组织键，避免重复指定键前缀：
//设置每次开始的组名，这样往下添加value时不同添加组名前缀
settings.beginGroup("mainwindow");
settings.setValue("geometry", someGeometry);
settings.setValue("state", someState);
settings.endGroup();
读取时也可以使用 beginGroup：
settings.beginGroup("mainwindow");
QVariant geometry = settings.value("geometry");
QVariant state = settings.value("state");
settings.endGroup();
小结
QSettings 是管理应用程序配置的强大工具，适用于存储用户偏好、应用程序状态等各种设置。通过其灵活的接口，你可以轻松地保存和加载各种数据类型，并支持跨平台的数据存储。