Qt框架中如何读写xml文件 QXmlStreamReader和QXmlStreamWriter的使用
QXmlStreamReader和QXmlStreamWriter是Qt中轻量高效的流式XML处理类，适用于无需DOM树的场景；2. 使用QXmlStreamReader需创建并打开QFile，通过readNext()逐个读取标签、文本等元素，结合name()、attributes()、text()等方法解析数据。
在Qt中处理XML文件，QXmlStreamReader 和 QXmlStreamWriter 是两个轻量、高效且易于使用的类。它们基于流式处理，适合读写结构清晰的XML内容，特别适用于不需要完整DOM树的场景。
使用 QXmlStreamReader 读取 XML 文件
QXmlStreamReader 从输入源（如 QFile）逐个读取 XML 元素，通过循环解析每个 token（标签、文本、属性等）来提取数据。
基本使用步骤：- 创建 QFile 并打开为只读模式
- 将文件传入 QXmlStreamReader 构造函数
- 使用 readNext() 遍历每个元素，判断类型后处理
- 利用 name()、attributes()、text() 等方法获取内容
示例代码：读取一个简单的配置文件
QFile file("config.xml");
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
qWarning() << "无法打开文件";
return;
}
QXmlStreamReader xml(&file);
while (!xml.atEnd()) {
xml.readNext();
if (xml.isStartElement()) {
if (xml.name() == "setting") {
auto attrs = xml.attributes();
if (attrs.hasAttribute("name") && attrs.hasAttribute("value")) {
qDebug() << "配置项:" << attrs.value("name").toString()
<< "=" << attrs.value("value").toString();
}
}
}
}
if (xml.hasError()) {
qWarning() << "解析错误:" << xml.errorString();
}
使用 QXmlStreamWriter 写入 XML 文件
QXmlStreamWriter 将数据以流的方式写入设备（如 QFile），自动处理转义字符和格式化输出。
基本使用步骤：- 创建 QFile 并以写入模式打开
- 构造 QXmlStreamWriter 实例，可设置自动格式化
- 调用 writeStartDocument() 开始文档
- 使用 writeStartElement / writeAttribute / writeCharacters 等写入内容
- 调用 writeEndDocument() 结束并关闭文件
示例代码：生成上述 config.xml
QFile file("config.xml");
if (!file.open(QIODevice::WriteOnly | QIODevice::Truncate | QIODevice::Text)) {
qWarning() << "无法创建文件";
return;
}
QXmlStreamWriter xml(&file);
xml.setAutoFormatting(true); // 启用缩进美化
xml.writeStartDocument();
xml.writeStartElement("settings");
xml.writeStartElement("setting");
xml.writeAttribute("name", "username");
xml.writeAttribute("value", "alice");
xml.writeEndElement(); // setting
xml.writeStartElement("setting");
xml.writeAttribute("name", "timeout");
xml.writeAttribute("value", "30");
xml.writeEndElement(); // setting
xml.writeEndElement(); // settings
xml.writeEndDocument(); // 关闭所有标签
注意事项与技巧
使用这两个类时注意以下几点：
- 始终检查文件是否成功打开
- 写入完成后建议调用 writeEndDocument()，确保正确闭合标签
- 读取时注意调用
hasError() 判断是否发生解析错误 - 支持嵌套结构，需配合 isStartElement/isEndElement 正确处理层级
- 可读取 CDATA、注释等节点，使用 isCDATA()/isComment() 判断类型
hasError() 判断是否发生解析错误基本上就这些。对于大多数配置或数据交换场景，QXmlStreamReader 和 QXmlStreamWriter 提供了简洁高效的解决方案，无需引入复杂 DOM 模型。只要逻辑清晰地处理开始/结束标签和文本内容，就能稳定读写标准 XML 文件。
