如何将QList<QMap<QString,float>>保存至QSettings文件？

QSettings确实搞不定这种嵌套的复杂容器类型——它的设计初衷是保存应用配置项（比如窗口尺寸、用户偏好），只支持基本类型和简单容器（比如QList<QString>），对QList<QMap<QString, float>>这种嵌套结构没有内置支持。下面是两种Qt原生的可行方案：

方案1：用QDataStream序列化（高效，Qt原生） #

QDataStream对Qt的容器类有完美的内置支持，序列化速度快，文件体积小，非常适合大量数据的存储。

保存数据的代码： #

bool saveComplexData(const QList<QMap<QString, float>>& data, const QString& filePath) {
    QFile outputFile(filePath);
    if (!outputFile.open(QIODevice::WriteOnly)) {
        qWarning() << "无法打开文件写入：" << outputFile.errorString();
        return false;
    }

    QDataStream out(&outputFile);
    out.setVersion(QDataStream::Qt_5_15); // 请匹配你的Qt版本，避免兼容性问题
    out << data; // 直接序列化整个列表，QDataStream会处理嵌套的QMap

    outputFile.close();
    return true;
}

加载数据的代码： #

bool loadComplexData(QList<QMap<QString, float>>& data, const QString& filePath) {
    QFile inputFile(filePath);
    if (!inputFile.open(QIODevice::ReadOnly)) {
        qWarning() << "无法打开文件读取：" << inputFile.errorString();
        return false;
    }

    QDataStream in(&inputFile);
    in.setVersion(QDataStream::Qt_5_15); // 必须和保存时的版本一致
    in >> data;

    inputFile.close();
    return true;
}

注意：一定要指定QDataStream的版本，不同Qt版本的序列化格式可能有差异，版本不匹配会导致加载失败。

方案2：用JSON序列化（可读，方便调试） #

如果需要文件内容是人类可读的（方便调试或手动修改），可以用QJsonDocument把数据转换成JSON格式存储。

保存为JSON的代码： #

bool saveDataToJson(const QList<QMap<QString, float>>& data, const QString& filePath) {
    QJsonArray jsonArray;
    for (const auto& mapItem : data) {
        QJsonObject jsonObj;
        // 把每个QMap转换成QJsonObject
        for (auto mapIt = mapItem.constBegin(); mapIt != mapItem.constEnd(); ++mapIt) {
            jsonObj[mapIt.key()] = mapIt.value(); // float会自动转成JSON的double类型
        }
        jsonArray.append(jsonObj);
    }

    QJsonDocument doc(jsonArray);
    QFile jsonFile(filePath);
    if (!jsonFile.open(QIODevice::WriteOnly)) {
        qWarning() << "无法打开JSON文件写入：" << jsonFile.errorString();
        return false;
    }

    // 写入格式化后的JSON，可读性更好
    jsonFile.write(doc.toJson(QJsonDocument::Indented));
    jsonFile.close();
    return true;
}

从JSON加载的代码： #

bool loadDataFromJson(QList<QMap<QString, float>>& data, const QString& filePath) {
    QFile jsonFile(filePath);
    if (!jsonFile.open(QIODevice::ReadOnly)) {
        qWarning() << "无法打开JSON文件读取：" << jsonFile.errorString();
        return false;
    }

    QByteArray jsonBytes = jsonFile.readAll();
    QJsonDocument doc = QJsonDocument::fromJson(jsonBytes);
    if (!doc.isArray()) {
        qWarning() << "JSON文件内容不是数组格式";
        return false;
    }

    QJsonArray jsonArray = doc.array();
    data.clear();
    for (const auto& jsonVal : jsonArray) {
        if (!jsonVal.isObject()) {
            qWarning() << "JSON数组中存在无效元素";
            continue;
        }
        QJsonObject jsonObj = jsonVal.toObject();
        QMap<QString, float> mapItem;
        // 把QJsonObject转回QMap
        for (auto jsonIt = jsonObj.constBegin(); jsonIt != jsonObj.constEnd(); ++jsonIt) {
            if (jsonIt.value().isDouble()) {
                // JSON中所有数字都是double，转成float即可
                mapItem[jsonIt.key()] = static_cast<float>(jsonIt.value().toDouble());
            } else {
                qWarning() << "键" << jsonIt.key() << "对应的值不是有效的数字";
            }
        }
        data.append(mapItem);
    }

    jsonFile.close();
    return true;
}

小提示：JSON中没有专门的float类型，所以保存时会转成double，加载时再转回float，精度损失几乎可以忽略，适合大多数场景。

为什么QSettings不行？ #

QSettings的底层存储格式（比如INI文件、Windows注册表）不适合存储嵌套的复杂容器，它只支持扁平的键值对或者简单的一维容器，所以你之前尝试用QSettings保存失败是正常的。

内容的提问来源于stack exchange，提问作者Alaa Agwa