一、JSON文件操作

1. 核心类

QJsonDocument：表示整个JSON文档，提供解析（fromJson()）和序列化（toJson()）功能。
QJsonObject：存储键值对集合，支持嵌套对象和数组。
QJsonArray：存储有序值列表。
QJsonValue：封装JSON支持的数据类型（字符串、数字、布尔值等）

2. 读写操作

读取JSON文件：

QFile file("config.json");
if (!file.open(QIODevice::ReadOnly)) 
{return; // 错误处理
}
// 读取文件
QByteArray jsonStr = file.readAll();
// 关闭文件
file.close();// 将json字符串转化为json文档
QJsonDocument jsonDoc = QJsonDocument::format(jsonStr);// 将json文档转化为json对象
QJsonObject jsonObj = jsonDoc.object();// 获取对应的数据，获取的类型默认值为QJsonValue
jsonObj.value("键").to对应的类型转化;

写入JSON文件:

// 创建json对象
QJsonObject rootObj;
// 插入内容
rootObj.insert("key","value");// 将json对象转化为json文档
QJsonDocument jsonDoc(jsonObj);
// 将json文档转化为json字符串
QByteArray jsonStr = jsonDoc.toJson(QJsonDocument::Compact);
// 打开文件
QFile file("相对路径/绝对路径");
if(!file.open(QIODevide::WriteOnly))
{return;// 错误处理
}
// 写入json字符串
file.write(jsonStr);
// 关闭文件
file.close();

二、XML文件操作

1. 两种处理方式对比

方法	适用场景	核心类
DOM模型	小文件、需随机访问或修改	`QDomDocument, QDomNode`
流式处理	大文件、只需顺序读写	`QXmlStreamReader/Writer`

2. DOM模型示例

读取XML：

// 1、载入xml文档
QDomDocument doc;QFile file("相对路径/绝对路径");if(!file.open(QIODevice::ReadOnly))
{qDebug() << "文件打开失败";return;
}QString errorMsg;
int errorLine, errorColumn;
if(!doc.setContent(&file, &errorMsg, &errorLine, &errorColumn))
{qDebug() << "XML解析错误：" << errorMsg << "at line" << errorLine << "column" << errorColumn;file.close();return;
}qDebug() << "文件读取成功";
file.close();// 2、读取头部信息
QDomNode head = doc.firstChild();
qDebug() << head.nodeName() << head.nodeType() << head.nodeValue();// 3、获取根节点
QDomElement rootEle = doc.documentElement();
qDebug() << rootEle.nodeName() << rootEle.nodeType() << rootEle.nodeValue() << rootEle.tagName();// 4、获取name标签
QDomElement nameEle = rootEle.firstChild().toElement();
qDebug() << nameEle.nodeName() << nameEle.nodeType() << nameEle.nodeValue();
qDebug() << nameEle.tagName() << nameEle.text() << nameEle.attribute("id") << nameEle.attribute("height");// 循环son获取数据
QDomElement sonEle = nameEle.nextSiblingElement("son");
QDomNode node = sonEle.firstChild();while (node.isElement()) 
{QDomElement temp = node.toElement();qDebug() << temp.text();node = temp.nextSiblingElement();
}

读取XML表格：

QDomDocument doc;QFile file("相对路径/绝对路径");
if(!file.open(QIODevice::ReadOnly))
{qDebug() << "文件打开失败";return;
}
qDebug() << doc.setContent(&file);//通过 elementsByTagName 来获取标签对象
QDomNodeList namels = doc.elementsByTagName("book-name");
QDomNodeList authorls = doc.elementsByTagName("author");
QDomNodeList pricels = doc.elementsByTagName("price");
QDomNodeList pubdatels = doc.elementsByTagName("publish-date");
// 设置表格大小
ui->tableWidget->setRowCount(namels.size());
ui->tableWidget->setColumnCount(4);
ui->tableWidget->setHorizontalHeaderLabels({"书名","作者","价格","出版日期"});// 因为 nameList、authorList等链表的长度是一样的，所以使用一个循环即可
for(int i = 0;i < namels.size();i++)
{QDomElement nameEle = namels.at(i).toElement();qDebug() << nameEle.tagName() << nameEle.text();QDomElement authorEle = authorls.at(i).toElement();QDomElement priceEle = pricels.at(i).toElement();QDomElement pubdateEle = pubdatels.at(i).toElement();//ui->tableWidget->setItem(i,0,new QTableWidgetItem(nameEle.nextSiblingElement().text()));ui->tableWidget->setItem(i,0,new QTableWidgetItem(nameEle.text()));ui->tableWidget->setItem(i,1,new QTableWidgetItem(authorEle.text()));ui->tableWidget->setItem(i,2,new QTableWidgetItem(priceEle.text()));ui->tableWidget->setItem(i,3,new QTableWidgetItem(pubdateEle.text()));
}file.close();

写入XML：

// 1、在内存当中创建doc树
// 1.1、创建一个空的dom树
QDomDocument doc;// 1.2、创建头部标签
QDomProcessingInstruction head = doc.createProcessingInstruction("xml","version='1.0' encoding='utf-8'");
// 追加给dom树
doc.appendChild(head);// 1.3、添加跟标签
QDomElement rootEle = doc.createElement("root");
// 追加给dom树
doc.appendChild(rootEle);// 1.4、向根标签中添加子标签
QDomElement userEle = doc.createElement("user");
rootEle.appendChild(userEle);// 向子标签添加属性
userEle.setAttribute("id","0101");
QDomText textEle = doc.createTextNode("张无忌");
userEle.appendChild(textEle);// 2、将doc树写入文件
QFile file("相对路径/绝对路径");
if(!file.open(QIODevice::WriteOnly))
{qDebug() << "文件打开失败";return;
}
QTextStream out(&file);
doc.save(out,4);
file.close();

3. 流式处理示例

读取XML：

// 载入xml文档，并将节点都保存为“记号”
QFile file("相对路径/绝对路径");
if(!file.open(QIODevice::ReadOnly))
{qDebug() << "文件打开失败";return;
}QXmlStreamReader reader;
reader.setDevice(&file);// 循环获得标记
while(!reader.atEnd())
{// 找到下一个记号，并保存该记号的类型QXmlStreamReader::TokenType type = reader.readNext();if(type == QXmlStreamReader::StartDocument){qDebug() << reader.documentVersion() << reader.documentEncoding();}else if(type == QXmlStreamReader::StartElement){if(reader.attributes().hasAttribute("id")){QString id = reader.attributes().value("id").toString();qDebug() << QString("<%1 id=\"%2\">").arg(reader.name()).arg(id);}else {qDebug() << QString("<%1>").arg(reader.name());}}else if(type == QXmlStreamReader::EndElement){qDebug() << QString("</%1>").arg(reader.name());}else if(type == QXmlStreamReader::Characters && !reader.isWhitespace()){qDebug() << reader.text();}
}file.close();

写入XML：

// 1、使用写入流绑定一个xml文件(目的就是向文件中写入内容)
QFile file("相对路径/绝对路径");
if(!file.open(QIODevice::WriteOnly))
{qDebug() << "文件打开失败";return;
}QXmlStreamWriter writer(&file);// 2、向xml中写入内容
// 实现自动格式化文档
writer.setAutoFormatting(true);// 创建头
// <?xml version="1.0" encoding="utf-8"?>
writer.writeStartDocument();// 创建第一个元素
// <user>
writer.writeStartElement("user");
// <name id="1001" height="175.8">于谦</name>
writer.writeStartElement("name");
writer.writeAttribute("id","1001");
writer.writeAttribute("height","175.8");
writer.writeCharacters("于谦");
writer.writeEndElement();// <isMarry>true</isMarry>
writer.writeTextElement("isMarray","true");// </user>
writer.writeEndElement();// 关闭文档
writer.writeEndDocument();
// 3、关闭文件
file.close();

三、总结

配置文件存储：
JSON：适合结构简单、需频繁读写的配置（如用户设置）。
XML：适合复杂结构或需验证的场景（如SOAP通信、文档格式）。
路径管理：
外部文件路径用QCoreApplication::applicationDirPath()获取。
版本兼容：
Qt 6移除了QJsonDocument::fromBinaryData()，优先使用文本格式