怎么把json文件保存qt

如何在Qt中保存JSON文件：详细指南与代码示例

在Qt开发中,JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，常用于配置文件、数据存储与网络通信，将数据保存为JSON文件是Qt开发中的常见需求，本文将详细介绍如何在Qt中高效保存JSON文件，涵盖从基础准备到代码实现的全流程，并提供不同场景下的解决方案。

Qt中处理JSON的基础准备

Qt提供了强大的QJsonDocument、QJsonObject、QJsonArray等类来处理JSON数据，这些类位于QtJson模块中，在使用前，需确保项目已正确配置：

添加Qt模块依赖

在.pro文件中添加json模块：

QT += core gui json

包含头文件

在代码中引入JSON相关头文件：

#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QFile>
#include <QTextStream>
#include <QDebug>

JSON文件保存的核心步骤

保存JSON文件的核心流程可概括为三步：构建JSON数据 → 转换为文档格式 → 写入文件，以下是详细实现方法。

方法1：使用QJsonDocument与QFile（推荐）

这是最常用且高效的方式,适合结构化数据（如配置信息、对象数组等）的保存。

构建JSON数据

根据数据类型选择QJsonObject（键值对对象）或QJsonArray（数组），并填充数据：

• 示例：保存一个用户对象

  // 创建JSON对象
  QJsonObject userObject;
  userObject["name"] = "张三";
  userObject["age"] = 25;
  userObject["email"] = "zhangsan@example.com";
  // 可选：添加嵌套对象
  QJsonObject addressObject;
  addressObject["city"] = "北京";
  addressObject["district"] = "朝阳区";
  userObject["address"] = addressObject;
  // 可选：添加数组字段（如爱好列表）
  QJsonArray hobbiesArray;
  hobbiesArray.append("阅读");
  hobbiesArray.append("游泳");
  hobbiesArray.append("编程");
  userObject["hobbies"] = hobbiesArray;

转换为QJsonDocument

QJsonDocument是JSON数据的容器，可将QJsonObject或QJsonArray转换为字节流，并支持格式化输出（便于阅读）：

// 将JSON对象转换为QJsonDocument
QJsonDocument doc(userObject);
// 设置保存格式（缩进2个空格，美化输出）
doc.setDocumentFormat(QJsonDocument::Indented); // 可选，默认为Compact格式（无缩进）

写入文件

使用QFile创建文件对象，以写入模式（QIODevice::WriteOnly或QIODevice::ReadWrite）打开文件，并通过QTextStream或直接写入字节数据：

// 创建文件对象（路径可自定义，如绝对路径或相对路径）
QFile file("user.json");
if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    qWarning() << "无法打开文件进行写入:" << file.errorString();
    return;
}
// 方式1：直接写入字节数据（适合二进制格式）
file.write(doc.toJson());
// 方式2：通过QTextStream写入（适合文本格式，可指定编码）
// QTextStream stream(&file);
// stream.setEncoding(QStringConverter::Utf8); // 确保UTF-8编码，避免中文乱码
// stream << doc.toJson();
// 关闭文件
file.close();

完整代码示例

#include <QCoreApplication>
#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QFile>
#include <QDebug>
void saveJsonToFile() {
    // 1. 构建JSON数据
    QJsonObject userObject;
    userObject["name"] = "张三";
    userObject["age"] = 25;
    userObject["email"] = "zhangsan@example.com";
    QJsonObject addressObject;
    addressObject["city"] = "北京";
    addressObject["district"] = "朝阳区";
    userObject["address"] = addressObject;
    QJsonArray hobbiesArray;
    hobbiesArray.append("阅读");
    hobbiesArray.append("游泳");
    hobbiesArray.append("编程");
    userObject["hobbies"] = hobbiesArray;
    // 2. 转换为QJsonDocument
    QJsonDocument doc(userObject);
    doc.setDocumentFormat(QJsonDocument::Indented); // 美化输出
    // 3. 写入文件
    QFile file("user.json");
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        qWarning() << "无法打开文件:" << file.errorString();
        return;
    }
    file.write(doc.toJson());
    file.close();
    qDebug() << "JSON文件保存成功！";
}
int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);
    saveJsonToFile();
    return a.exec();
}

生成的user.json

{
    "name": "张三",
    "age": 25,
    "email": "zhangsan@example.com",
    "address": {
        "city": "北京",
        "district": "朝阳区"
    },
    "hobbies": [
        "阅读",
        "游泳",
        "编程"
    ]
}

方法2：保存QJsonArray（数组数据场景）

若需保存的是数组数据（如列表、批量记录），只需将QJsonObject替换为QJsonArray，其余步骤相同：

void saveJsonArrayToFile() {
    // 1. 构建JSON数组
    QJsonArray usersArray;
    // 添加第一个用户
    QJsonObject user1;
    user1["name"] = "李四";
    user1["age"] = 30;
    usersArray.append(user1);
    // 添加第二个用户
    QJsonObject user2;
    user2["name"] = "王五";
    user2["age"] = 28;
    usersArray.append(user2);
    // 2. 转换为QJsonDocument
    QJsonDocument doc(usersArray);
    doc.setDocumentFormat(QJsonDocument::Indented);
    // 3. 写入文件
    QFile file("users.json");
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        qWarning() << "无法打开文件:" << file.errorString();
        return;
    }
    file.write(doc.toJson());
    file.close();
    qDebug() << "JSON数组文件保存成功！";
}

生成的users.json

[
    {
        "name": "李四",
        "age": 30
    },
    {
        "name": "王五",
        "age": 28
    }
]

方法3：处理复杂数据（从C++对象映射）

若需将C++自定义类对象保存为JSON，可通过手动序列化（转换为JSON对象）或使用第三方库（如QtJsonSerializer）简化操作，以下是手动序列化的示例：

示例：保存Student对象

#include <QString>
#include <QVector>
class Student {
public:
    QString name;
    int id;
    QVector<QString> courses;
    // 手动转换为QJsonObject
    QJsonObject toJson() const {
        QJsonObject obj;
        obj["name"] = name;
        obj["id"] = id;
        QJsonArray coursesArray;
        for (const QString &course : courses) {
            coursesArray.append(course);
        }
        obj["courses"] = coursesArray;
        return obj;
    }
};
void saveStudentToFile() {
    Student student;
    student.name = "赵六";
    student.id = 1001;
    student courses << "高等数学" << "大学物理" << "C++程序设计";
    QJsonDocument doc(student.toJson());
    doc.setDocumentFormat(QJsonDocument::Indented);
    QFile file("student.json");
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        qWarning() << "无法打开文件:" << file.errorString();
        return;
    }
    file.write(doc.toJson());
    file.close();
    qDebug() << "Student对象保存成功！";
}

生成的student.json

{
    "name": "赵六",
    "id": 1001,
    "courses": [
        "高等数学",
        "大学物理",
        "C++程序设计"
    ]
}

关键注意事项

文件路径与编码

• 路径：建议使用QFileInfo处理路径，确保跨平台兼容性（如Windows使用\，Linux/macOS使用）。

  QFileInfo fileInfo("config", "