C++ Qt JSON解析库QJsonDocument使用详解

夏知夏

发布时间：2026-10-16| 5人浏览过

原创

在C++开发中，利用Qt框架自带的JSON支持库可以高效地处理数据交换格式。本文将通过具体实例，演示如何使用QJsonDocument及相关类读取JSON文件，并针对单一字段、嵌套对象、嵌套数组等常见结构提供完整的解析代码。

准备工作与核心头文件

在进行JSON解析前，需确保项目包含必要的Qt模块头文件。主要依赖类包括用于文档解析的QJsonDocument，用于处理对象和数组的QJsonObject与QJsonArray，以及用于读取文件的QFile和QTextStream。

第1步：准备测试JSON配置文件

为了便于演示各种数据结构，首先创建一个名为config.json的配置文件，其中包含单一键值对、对象、数组以及嵌套结构。

{
    "blog": "https://example.com",
    "enable": true,
    "status": 1024,
    
    "GetDict": {"address":"192.168.1.1","username":"root","password":"123456","update":"2020-09-26"},
    "GetList": [1,2,3,4,5,6,7,8,9,0],
    
    "ObjectInArrayJson":
    {
        "One": ["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],
        "Two": ["Sunday","Monday","Tuesday"]
    },
    
    "ArrayJson": [
        ["192.168.1.1","root","22"],
        ["192.168.1.2","root","23"],
        ["192.168.1.3","root","24"],
        ["192.168.1.4","root","25"],
        ["192.168.1.5","root","26"]
    ],
    
    "ObjectJson": [
        {"address":"192.168.1.1","username":"admin"},
        {"address":"192.168.1.2","username":"root"},
        {"address":"192.168.1.3","username":"lyshark"}
    ]
}

第2步：实现JSON文件读取工具函数

解析JSON的第一步是将文件内容读取为字符串。以下代码封装了readonly_string函数，负责检查文件存在性并以只读文本模式打开，返回完整字符串内容。若文件不存在或读取失败，则返回"None"作为错误标识。

QString readonly_string(QString file_path)
{
    QFile this_file_ptr(file_path);
    if(false == this_file_ptr.exists())
    {
        return "None";
    }
    if(false == this_file_ptr.open(QIODevice::ReadOnly | QIODevice::Text))
    {
        return "None";
    }
    QString string_value = this_file_ptr.readAll();
    this_file_ptr.close();
    return string_value;
}

解析基础结构：根节点单一字段

第3步：解析根对象中的简单键值对

目标：提取blog（字符串）、enable（布尔值）和status（整型）字段。此操作展示了如何从JSON文档获取根对象并进行类型安全的数据提取。

入口：调用QJsonDocument::fromJson将字符串转换为文档对象。
动作：调用.object()获取根节点QJsonObject。
参数：使用.find("key").value().toType()链式调用进行取值。
状态：控制台输出正确的字段值即表示成功。

// 读取JSON文本并转为文档
QString config = readonly_string("d:/config.json");
if(config == "None") return 0;

QJsonParseError err_rpt;
QJsonDocument root_document = QJsonDocument::fromJson(config.toUtf8(), &err_rpt);
if(err_rpt.error != QJsonParseError::NoError)
{
    std::cout << "JSON格式错误" << std::endl;
    return 0;
}

// 获取根节点
QJsonObject root_object = root_document.object();

// 解析blog字段 (字符串)
QString blog = root_object.find("blog").value().toString();
std::cout << "字段对应的值 = > " << blog.toStdString() << std::endl;

// 解析enable字段 (布尔)
bool enable = root_object.find("enable").value().toBool();
std::cout << "是否开启状态: " << enable << std::endl;

// 解析status字段 (整数)
int status = root_object.find("status").value().toInt();
std::cout << "状态数值: " << status << std::endl;

解析中间结构：单对象与单数组

第4步：解析嵌套对象（GetDict）与简单数组（GetList）

目标：解析GetDict对象中的详细信息，以及GetList数组中的数字列表。对于对象，可以使用QVariantMap进行便捷的键值访问；对于数组，则通过索引遍历。

对象解析：将GetDict转换为QVariantMap，检查键是否存在后直接取值。
数组解析：将对应值转为QJsonArray，循环遍历每个元素并转为目标类型。

// 解析单一对象 GetDict
QJsonObject get_dict_ptr = root_object.find("GetDict").value().toObject();
QVariantMap map = get_dict_ptr.toVariantMap();
if(map.contains("address") && map.contains("username") && map.contains("password") && map.contains("update"))
{
    QString address = map["address"].toString();
    QString username = map["username"].toString();
    QString password = map["password"].toString();
    QString update = map["update"].toString();
    std::cout << "地址: " << address.toStdString()
              << " 用户名: " << username.toStdString()
              << " 密码: " << password.toStdString()
              << " 更新日期: " << update.toStdString() << std::endl;
}

// 解析单一数组 GetList
QJsonArray get_list_ptr = root_object.find("GetList").value().toArray();
for(int index=0; index < get_list_ptr.count(); index++)
{
    int ref_value = get_list_ptr.at(index).toInt();
    std::cout << "输出数组元素: " << ref_value << std::endl;
}

解析复杂结构：嵌套与多重遍历

第5步：解析对象内嵌数组（ObjectInArrayJson）

目标：ObjectInArrayJson是一个包含两个数组字段（One和Two）的对象。需先定位该对象，再将其转为映射表，分别提取其中的数组并遍历输出。

// 找到Object对象
QJsonObject one_object_json = root_object.find("ObjectInArrayJson").value().toObject();
QVariantMap map = one_object_json.toVariantMap();

// 寻找One键对应的数组
QJsonArray array_one = map["One"].toJsonArray();
for(int index=0; index < array_one.count(); index++)
{
    QString value = array_one.at(index).toString();
    std::cout << "One => " << value.toStdString() << std::endl;
}

// 寻找Two键对应的数组
QJsonArray array_two = map["Two"].toJsonArray();
for(int index=0; index < array_two.count(); index++)
{
    QString value = array_two.at(index).toString();
    std::cout << "Two => " << value.toStdString() << std::endl;
}

第6步：解析数组中的数组结构（ArrayJson）

目标：ArrayJson是一个二维数组，每个元素本身也是一个包含IP、用户和端口的数组。需注意循环边界条件，避免越界访问。

验证ArrayJson是否为数组。
外层循环遍历子数组。
内层判断子元素是否为数组，若是则提取其内部字段。

// 获取MyJson数组
QJsonValue array_value = root_object.value("ArrayJson");
if(array_value.isArray())
{
    // 得到数组个数
    int array_count = array_value.toArray().count();
    // 循环数组个数（注意边界控制）
    for(int index=0; index < array_count; index++)
    {
        QJsonValue parset = array_value.toArray().at(index);
        if(parset.isArray())
        {
            QString address = parset.toArray().at(0).toString();
            QString username = parset.toArray().at(1).toString();
            QString userport = parset.toArray().at(2).toString();
            std::cout << "地址: " << address.toStdString()
                      << " 用户名: " << username.toStdString()
                      << " 端口号: " << userport.toStdString() << std::endl;
        }
    }
}

第7步：解析数组中的多对象结构（ObjectJson）

目标：ObjectJson是一个包含多个JSON对象的数组。需遍历数组中的每一项，将其转换为QJsonObject并验证非空后提取字段。

// 获取MyJson数组
QJsonValue object_value = root_object.value("ObjectJson");
if(object_value.isArray())
{
    // 获取对象个数
    int object_count = object_value.toArray().count();
    // 循环个数（注意边界控制）
    for(int index=0; index < object_count; index++)
    {
        QJsonObject obj = object_value.toArray().at(index).toObject();
        // 验证数组不为空
        if(!obj.isEmpty())
        {
            QString address = obj.value("address").toString();
            QString username = obj.value("username").toString();
            std::cout << "地址: " << address.toStdString() 
                      << " 用户: " << username.toStdString() << std::endl;
        }
    }
}

简要总结

通过上述步骤，我们系统地掌握了Qt中解析JSON的各种场景。关键在于正确识别数据的层级结构，并使用toObject、toArray等方法进行类型转换。对于嵌套结构，遵循“由外向内”逐层提取的原则即可。以上就是C++ Qt运用JSON解析库的详细应用教程，更多关于Qt编程的资料请关注本站其它相关文章！