qt中需手动用qxmlstreamwriter/qxmlstreamreader序列化qwidget布局，提取geometry、visible等属性存为xml节点，恢复时须在show后按adddockwidget→setfloating→setvisible→setgeometry顺序操作，并注意dpi适配与停靠状态处理。
Qt 中用 QXmlStreamWriter 保存 QWidget 布局到 XML
Qt 没有内置的“窗口布局自动序列化”机制，QWidget 本身不支持直接序列化。必须手动提取关键属性（位置、大小、可见性、展开状态等），再写入 XML。别指望 QMetaObject 能自动导出所有 UI 状态——它只管元信息，不管运行时布局数据。
核心思路是遍历目标容器（如 QMainWindow 的 centralWidget 或 QDockWidget 列表），逐个读取 geometry()、isHidden()、isVisible()、isFloating()（对 dock）、sizeHint()（可选）等，并为每个控件生成一个 <widget></widget> 节点。
示例：保存主窗口中所有 QDockWidget 的状态
void saveLayoutToXml(const QString &path, QMainWindow *mainWin) {
QFile file(path);
if (!file.open(QIODevice::WriteOnly | QIODevice::Truncate))
return;
QXmlStreamWriter xml(&file);
xml.setAutoFormatting(true);
xml.writeStartDocument();
xml.writeStartElement("layout");
for (QDockWidget *dock : mainWin->findChildren<qdockwidget>()) {
xml.writeStartElement("dock");
xml.writeAttribute("name", dock->objectName());
xml.writeAttribute("visible", dock->isVisible() ? "true" : "false");
xml.writeAttribute("floating", dock->isFloating() ? "true" : "false");
xml.writeAttribute("geometry", dock->geometry().toString()); // 注意：浮窗用 geometry()，停靠时用 dock->toggleViewAction()->isChecked() 更可靠
xml.writeEndElement();
}
xml.writeEndElement();
xml.writeEndDocument();
file.close();
}</qdockwidget>
用 QXmlStreamReader 从 XML 恢复窗口布局
读取时不能简单调用 setGeometry() 就完事——窗口尚未 show，或处于不同 DPI 缩放下，geometry 可能被系统忽略或重算。必须在 show() 后、且确保父窗口已布局完成后再应用；更稳妥的做法是延迟到 QEvent::Show 或首次 resizeEvent 后执行恢复逻辑。
常见错误：在构造函数里直接 parse XML 并 setGeometry → 无效，因为 widget 尚未被 parent 管理或未进入事件循环。
要点：
- 用
QObject::findChild<t>("name")</t>根据name属性查找控件，而非硬编码顺序 - 对
QDockWidget，先调用mainWin->addDockWidget()，再设setFloating()和setVisible()，最后才setGeometry() - 若 XML 中没有某控件，跳过即可；不要报错中断整个加载流程
示例节选（恢复 dock）：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
void restoreLayoutFromXml(const QString &path, QMainWindow *mainWin) {
QFile file(path);
if (!file.open(QIODevice::ReadOnly))
return;
QXmlStreamReader xml(&file);
while (!xml.atEnd()) {
if (xml.readNext() == QXmlStreamReader::StartElement) {
if (xml.name() == "dock") {
QString name = xml.attributes().value("name").toString();
QDockWidget *dock = mainWin->findChild<qdockwidget>(name);
if (!dock) continue;
bool visible = xml.attributes().value("visible") == "true";
bool floating = xml.attributes().value("floating") == "true";
QRect geom = QRect::fromString(xml.attributes().value("geometry").toString());
mainWin->addDockWidget(Qt::LeftDockWidgetArea, dock);
dock->setFloating(floating);
dock->setVisible(visible);
if (floating && !geom.isEmpty())
dock->setGeometry(geom); // 浮动窗口才用 geometry
}
}
}
file.close();
}</qdockwidget>
为什么不用 QSettings + beginGroup/setValue？
QSettings 确实能存 QRect、bool、QString，也支持 INI / Registry / plist，但它不生成标准 XML，也不具备嵌套结构表达能力（比如无法自然表示“某个 tab 下第 3 个 splitter 的各段比例”）。如果你的布局含 QSplitter、QTabWidget 当前索引、QTreeView 展开路径等复合状态，XML 的树形结构更直观、易调试、跨平台兼容性更好。
但注意：QXmlStreamWriter 不校验 XML Schema，也不会自动转义特殊字符（如控件名含 & 或 ）。务必对 <code>objectName() 做白名单过滤，或改用 QXmlStreamWriter::writeCharacters() 配合 QXmlStreamWriter::escapeString()（需自行实现）。
更轻量替代方案：用 QVariantMap + QJsonDocument 写 JSON —— 可读性好、Qt 原生支持、无转义烦恼，只是不叫 XML。
容易被忽略的 DPI 和多屏适配问题
直接存 geometry().toString() 在高 DPI 屏幕上会出问题：比如 200% 缩放下保存的 QRect(100,100 400x300)，在 100% 屏上还原会显得太小。Qt 6.5+ 推荐用 QScreen::devicePixelRatio() 归一化坐标，或改用 QGuiApplication::primaryScreen()->availableGeometry() 做相对定位。
另一个坑：QDockWidget::geometry() 在停靠状态下返回的是无效矩形（常为 0,0 1x1），此时应记录的是它在哪个 Qt::DockWidgetArea、是否被隐藏、以及 QDockWidget::toggleViewAction()->isChecked() 状态，而不是强行读 geometry。
真实项目中，建议把 layout 数据拆成两层：基础层（dock 区域、tab 索引、splitter 比例） + 像素层（仅浮动窗口的绝对位置），后者加注释说明“仅用于同 DPI 同屏幕配置下还原”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
