Qt框架中如何读写xml文件 QXmlStreamReader和QXmlStreamWriter的使用

QXmlStreamReader和QXmlStreamWriter是Qt中轻量高效的流式XML处理类,适用于无需DOM树的场景;2. 使用QXmlStreamReader需创建并打开QFile,通过readNext()逐个读取标签、文本等元素,结合name()、attributes()、text()等方法解析数据。

在Qt中处理XML文件,QXmlStreamReaderQXmlStreamWriter 是两个轻量、高效且易于使用的类。它们基于流式处理,适合读写结构清晰的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() 判断类型

基本上就这些。对于大多数配置或数据交换场景,QXmlStreamReader 和 QXmlStreamWriter 提供了简洁高效的解决方案,无需引入复杂 DOM 模型。只要逻辑清晰地处理开始/结束标签和文本内容,就能稳定读写标准 XML 文件。