以下是使用 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;
}
注意事项
-
路径问题：
- 相对路径相对于当前工作目录
- 使用绝对路径避免歧义
-
性能考虑：
allKeys()会加载所有键到内存- 对于大文件，考虑分组遍历
-
编码问题：
- INI 文件默认使用 UTF-8
- 确保文件编码正确
-
线程安全：
- QSettings 不是线程安全的
- 多线程访问需要加锁
-
实时更新：
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