搜索菜单
当前位置: 首页 > C++ > C++ Qt JSON解析库QJsonDocument使用详解

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

夏知夏
夏知夏
发布时间：2026-10-16 | 4人浏览过
原创

在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文档获取根对象并进行类型安全的数据提取。

  1. 入口：调用QJsonDocument::fromJson将字符串转换为文档对象。
  2. 动作：调用.object()获取根节点QJsonObject。
  3. 参数：使用.find("key").value().toType()链式调用进行取值。
  4. 状态：控制台输出正确的字段值即表示成功。
// 读取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进行便捷的键值访问；对于数组，则通过索引遍历。

  1. 对象解析：将GetDict转换为QVariantMap，检查键是否存在后直接取值。
  2. 数组解析：将对应值转为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、用户和端口的数组。需注意循环边界条件，避免越界访问。

  1. 验证ArrayJson是否为数组。
  2. 外层循环遍历子数组。
  3. 内层判断子元素是否为数组，若是则提取其内部字段。
// 获取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编程的资料请关注本站其它相关文章！

相关文章

相关标签: C++ Qt JSON 后端开发

本站声明

本文内容仅供参考，不代表本站观点。转载或引用请注明出处。如发现内容问题，请通过联系我们页面反馈。

作者最新文章

全部内容

Python 相关产品和应用

全部下载
Python Selenium
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。
Python 机器学习
scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。
Python 代码质量
Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。
Python 代码质量
Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。
Python pytest
pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。
Python FastAPI API
FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架，支持类型提示和自动接口文档。
Python Flask Web开发
Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。
Python Django Web开发
Django

Django

6.1.2 · Windows

成熟的 Python Web 框架，适合构建内容站点和业务系统。
Python Spyder
Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。
Python SciPy
SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。
Python Pandas 数据分析
pandas

pandas

3.0.6 · Windows

Python 数据分析库，提供 DataFrame 与丰富的数据处理能力。
Python NumPy
NumPy

NumPy

2.5.4 · Windows

Python 科学计算基础库，提供高性能多维数组与数值运算。

文章分类

专题列表

ipython.cn 学习网
人工智能 Java AI行业服务