Qt框架的C++怎么读写XML文件 QXmlStreamReader/Writer

推荐使用QXmlStreamReader和QXmlStreamWriter处理XML:前者逐事件解析、省内存,后者提供清晰层级API、自动转义缩进;均优于DOM方式。

Qt 中读写 XML 文件推荐用 QXmlStreamReaderQXmlStreamWriter,它们是基于流的、轻量且高效的方式,比 DOM(QDomDocument)更省内存,适合处理中大型 XML 文件。

用 QXmlStreamWriter 写 XML 文件

写 XML 时,QXmlStreamWriter 提供清晰的层级 API,自动处理转义、缩进和格式(可选),关键是按“开始标签 → 内容 → 结束标签”顺序调用方法。

  • 先构造 QXmlStreamWriter,绑定到 QFileQByteArray
  • 调用 writeStartDocument() 开始文档(可指定版本/编码)
  • writeStartElement() 进入节点,writeAttribute() 写属性
  • writeCharacters() 写文本内容,writeEndElement() 关闭当前节点
  • 最后调用 writeEndDocument()

示例:生成一个简单配置 XML

QFile file("config.xml");
if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    QXmlStreamWriter stream(&file);
    stream.setAutoFormatting(true); // 自动缩进
    stream.writeStartDocument();
    stream.writeStartElement("config");
        stream.writeStartElement("window");
            stream.writeAttribute("width", "800");
            stream.writeAttribute("height", "600");
            stream.writeTextElement("title", "My App");
        stream.writeEndElement();
        stream.writeStartElement("theme");
            stream.writeCharacters("dark");
        stream.writeEndElement();
    stream.writeEndElement();
    stream.writeEndDocument();
    file.close();
}

用 QXmlStreamReader 读 XML 文件

QXmlStreamReader 是逐事件解析器(SAX 风格),不加载整个文档到内存。你需要循环调用 readNext(),根据 tokenType() 判断当前是什么节点(开始元素、文本、结束元素等),再用对应方法取值。

  • 确保文件以文本模式打开(QIODevice::ReadOnly | QIODevice::Text
  • 每次 readNext() 后检查 isStartElement()isEndElement()isCharacters()
  • name() 获取当前元素名,attributes() 取属性,text() 取文本内容
  • 注意:文本节点可能被拆成多个 Characters 事件,建议用 skipCurrentElement() 或累积处理

示例:读取上面生成的 config.xml 中 window 尺寸

QFile file("config.xml");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    QXmlStreamReader reader(&file);
    while (!reader.atEnd()) {
        reader.readNext();
        if (reader.isStartElement()) {
            if (reader.name() == "window") {
                auto attrs = reader.attributes();
                int w = attrs.value("width").toInt();
                int h = attrs.value("height").toInt();
                qDebug() << "Window size:" << w << "x" << h;
            } else if (reader.name() == "title") {
                reader.readNext(); // 跳到 Characters 节点
                if (reader.isCharacters())
                    qDebug() << "Title:" << reader.text().toString();
            }
        }
    }
    file.close();
}

常见注意事项

  • XML 编码需一致:写时指定 UTF-8(默认),读时确保文件本身是 UTF-8,否则中文可能乱码
  • 错误处理不能忽略:hasError()error() 要检查,尤其网络或用户提供的 XML 可能格式错误
  • 嵌套结构建议用栈或状态变量跟踪层级,避免硬编码深度判断
  • 不要依赖空白字符:XML 中换行缩进也是 Characters 事件,用 isWhitespace() 过滤掉

替代方案简要对比

如果 XML 很小、结构固定,用 QDomDocument 更直观(类似 JS 的 DOM 操作);但大文件易卡顿、占内存高。QXmlStreamReader/Writer 是 Qt 官方推荐的现代方式,兼顾性能与可控性。

基本上就这些。写 XML 记住“先开后关”,读 XML 记住“边走边判”,配合属性和文本提取,就能稳稳搞定大多数场景。