推荐使用QXmlStreamReader和QXmlStreamWriter处理XML：前者逐事件解析、省内存，后者提供清晰层级API、自动转义缩进；均优于DOM方式。
Qt 中读写 XML 文件推荐用 QXmlStreamReader 和 QXmlStreamWriter，它们是基于流的、轻量且高效的方式，比 DOM（QDomDocument）更省内存，适合处理中大型 XML 文件。
用 QXmlStreamWriter 写 XML 文件
写 XML 时，QXmlStreamWriter 提供清晰的层级 API，自动处理转义、缩进和格式（可选），关键是按“开始标签 → 内容 → 结束标签”顺序调用方法。
- 先构造
QXmlStreamWriter，绑定到QFile或QByteArray - 调用
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() 判断当前是什么节点（开始元素、文本、结束元素等），再用对应方法取值。
立即学习“C++免费学习笔记（深入）”；
- 确保文件以文本模式打开（
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 记住“边走边判”，配合属性和文本提取，就能稳稳搞定大多数场景。
