QSettings遍历ini的key

以下是使用 QSettings 遍历 INI 文件所有 key 的几种方法：

方法1：遍历所有顶级 key

#include <QSettings>
#include <QDebug>// 遍历顶级 key
void iterateTopLevelKeys() {QSettings settings("config.ini", QSettings::IniFormat);QStringList keys = settings.allKeys();qDebug() << "All keys (" << keys.size() << "):";for (const QString &key : keys) {QVariant value = settings.value(key);qDebug() << key << "=" << value;}
}

方法2：分组遍历（按 section/group）

void iterateByGroups() {QSettings settings("config.ini", QSettings::IniFormat);// 获取所有组QStringList groups = settings.childGroups();for (const QString &group : groups) {settings.beginGroup(group);qDebug() << "[" << group << "]";// 获取当前组的所有 keyQStringList keys = settings.childKeys();for (const QString &key : keys) {QVariant value = settings.value(key);qDebug() << "  " << key << "=" << value;}settings.endGroup();}
}

方法3：递归遍历（包含嵌套组）

void iterateRecursively(const QString &parentGroup = "") {QSettings settings("config.ini", QSettings::IniFormat);if (!parentGroup.isEmpty()) {settings.beginGroup(parentGroup);}// 遍历当前组的 keyQStringList keys = settings.childKeys();for (const QString &key : keys) {QString fullKey = parentGroup.isEmpty() ? key : parentGroup + "/" + key;QVariant value = settings.value(key);qDebug() << fullKey << "=" << value;}// 递归遍历子组QStringList groups = settings.childGroups();for (const QString &group : groups) {QString newParent = parentGroup.isEmpty() ? group : parentGroup + "/" + group;iterateRecursively(newParent);}if (!parentGroup.isEmpty()) {settings.endGroup();}
}

方法4：遍历特定类型的值

void iterateWithType() {QSettings settings("config.ini", QSettings::IniFormat);QStringList keys = settings.allKeys();for (const QString &key : keys) {QVariant value = settings.value(key);qDebug() << "Key:" << key;qDebug() << "  Type:" << value.typeName();qDebug() << "  Value:" << value;// 根据类型处理if (value.type() == QVariant::String) {qDebug() << "  String value:" << value.toString();} else if (value.type() == QVariant::Int) {qDebug() << "  Int value:" << value.toInt();} else if (value.type() == QVariant::Bool) {qDebug() << "  Bool value:" << value.toBool();}qDebug() << "---";}
}

方法5：使用迭代器模式

void iterateWithSync() {QSettings settings("config.ini", QSettings::IniFormat);// 确保读取最新数据settings.sync();const QStringList keys = settings.allKeys();// 使用 QList 迭代器for (auto it = keys.constBegin(); it != keys.constEnd(); ++it) {const QString &key = *it;qDebug() << key << "->" << settings.value(key);}
}

方法6：处理数组（带数字下标的键）

void iterateArrayKeys() {QSettings settings("config.ini", QSettings::IniFormat);QStringList keys = settings.allKeys();// 过滤出数组形式的键QRegularExpression arrayPattern("\\[\\d+\\]$");for (const QString &key : keys) {if (key.contains(arrayPattern)) {qDebug() << "Array key found:" << key;qDebug() << "Value:" << settings.value(key);}}
}

完整示例程序

#include <QCoreApplication>
#include <QSettings>
#include <QDebug>
#include <QFile>int main(int argc, char *argv[]) {QCoreApplication app(argc, argv);// 创建示例 INI 文件QSettings settings("example.ini", QSettings::IniFormat);// 写入测试数据settings.setValue("general/app_name", "MyApp");settings.setValue("general/version", "1.0.0");settings.setValue("database/host", "localhost");settings.setValue("database/port", 3306);settings.setValue("database/enabled", true);settings.setValue("window/x", 100);settings.setValue("window/y", 200);settings.sync(); // 确保写入文件// 方法1：遍历所有 keyqDebug() << "=== 方法1：所有键 ===";QStringList allKeys = settings.allKeys();for (const QString &key : allKeys) {qDebug() << key << ":" << settings.value(key);}// 方法2：分组遍历qDebug() << "\n=== 方法2：分组遍历 ===";QStringList groups = settings.childGroups();for (const QString &group : groups) {qDebug() << "\n[" << group << "]";settings.beginGroup(group);QStringList childKeys = settings.childKeys();for (const QString &key : childKeys) {qDebug() << "  " << key << ":" << settings.value(key);}settings.endGroup();}// 清理QFile::remove("example.ini");return 0;
}

注意事项

1. 路径问题：

   • 相对路径相对于当前工作目录
   • 使用绝对路径避免歧义

2. 性能考虑：

   • allKeys() 会加载所有键到内存
   • 对于大文件，考虑分组遍历

3. 编码问题：

   • INI 文件默认使用 UTF-8
   • 确保文件编码正确

4. 线程安全：

   • QSettings 不是线程安全的
   • 多线程访问需要加锁

5. 实时更新：

   settings.sync(); // 刷新缓存，读取最新数据
   

输出示例

假设 INI 文件内容：

[general]
app_name=MyApp
version=1.0.0[database]
host=localhost
port=3306
enabled=true

输出结果：

=== 方法1：所有键 ===
general/app_name : "MyApp"
general/version : "1.0.0"
database/host : "localhost"
database/port : 3306
database/enabled : true=== 方法2：分组遍历 ===[general]app_name : "MyApp"version : "1.0.0"[database]host : "localhost"port : 3306enabled : true