企业官网建设流程全解析

1. 从“浮动面板”说起：QDockWidget 到底解决什么问题

如果你用过任何一款稍微复杂点的桌面软件，比如代码编辑器、三维建模工具或者音视频剪辑软件，大概率见过这样的界面：主工作区周围散布着一个个可以拖动、可以关闭、可以重新排列的小面板。它们平时安安静静地贴在窗口边缘，需要的时候拖出来就变成独立小窗，不需要的时候一键收起或者关掉。这种“可停靠、可浮动、可重组”的面板机制，在 Qt Widgets 里就是由QDockWidget来承载的。

很多人第一次接触 QDockWidget，是在模仿某个成熟软件布局的时候。主窗口中间放一个绘图区或者文本编辑区，左右两侧各挂几个属性面板、图层列表、日志输出窗口。用 QSplitter 也能做出类似效果，但 QSplitter 的分割条只能拖动改变比例，没法把面板拖出来变成浮动窗口，也没法让用户自由决定某个面板停靠在左边还是右边。QDockWidget 补的正是这块能力：它把“面板”这个概念从固定布局里解放出来，交给用户去组织。

从继承关系上看，QDockWidget 直接继承自 QWidget，所以它本质上就是一个容器控件，里面可以塞任意 QWidget。它自己不负责主区域的布局，主区域通常由 QMainWindow 的 centralWidget 承担，而 QDockWidget 则通过addDockWidget()挂到 QMainWindow 的四个停靠区域上。这个分工很关键：QMainWindow 是舞台，centralWidget 是主角，QDockWidget 是配角。配角可以上下场、可以换位置，但主角始终占据中心。

我见过不少初学者把整个界面都塞进 QDockWidget，结果主区域空着，窗口一缩放就各种错位。这其实是对 QMainWindow 布局模型理解不到位。正确的做法是：把最核心、最常驻的内容放进setCentralWidget()，把辅助性的、可开关的内容做成 QDockWidget。这样用户即使把所有停靠窗口都关掉，主功能依然可用。

QDockWidget 的典型应用场景可以归纳成几类。第一类是属性/参数面板，比如图形编辑器里选中一个图元后，右侧显示它的坐标、颜色、线宽；第二类是资源/结构树，比如图层列表、文件目录树、场景节点树；第三类是日志/输出窗口，比如编译输出、运行日志、调试信息；第四类是工具箱/组件库，比如控件面板、素材库。这些内容的共同点是：它们重要但不总是需要，用户希望按需显示，并且不同用户对位置有不同偏好。QDockWidget 恰好把这种“偏好”交给用户自己管理。

还有一个容易被忽略的点：QDockWidget 天然支持状态保存与恢复。QMainWindow 提供了saveState()和restoreState()，可以把所有停靠窗口的位置、大小、可见性序列化成字节数组。这意味着你可以让软件记住用户上次退出时的布局，下次打开一模一样。这个能力在专业软件里几乎是标配，而用 QSplitter 手动实现会非常麻烦。所以如果你的界面有“多面板 + 用户自定义布局”的需求，QDockWidget 基本是绕不开的选择。

2. 把 QDockWidget 挂上主窗口：区域、方向与初始布局的取舍

2.1 四个停靠区域与addDockWidget的基本用法

QMainWindow 把停靠区域划分成四个：Qt::LeftDockWidgetArea、Qt::RightDockWidgetArea、Qt::TopDockWidgetArea、Qt::BottomDockWidgetArea。调用addDockWidget(area, dockWidget)就能把某个停靠窗口放到指定区域。代码大概长这样：

QMainWindow *mainWindow = new QMainWindow; QTextEdit *editor = new QTextEdit; mainWindow->setCentralWidget(editor); QDockWidget *propertyDock = new QDockWidget("属性", mainWindow); propertyDock->setWidget(new QTreeWidget); mainWindow->addDockWidget(Qt::RightDockWidgetArea, propertyDock);

这段代码跑起来，右侧就会出现一个标题为“属性”的停靠窗口。注意setWidget()只能设置一个子控件，如果你要放多个控件，得先套一个 QWidget 再用布局管理。这一点和普通容器控件一样，没什么特殊。

这里有个细节值得说：addDockWidget的第二个参数是 QDockWidget 指针，但 QMainWindow 并不会接管它的所有权意义上的“父子关系”之外的东西。也就是说，QDockWidget 的父对象是 QMainWindow，销毁主窗口时会一并销毁，但你不能把同一个 QDockWidget 同时 add 到两个 QMainWindow 上。实际项目中如果有多窗口需求，每个窗口都得创建自己的停靠窗口实例。

2.2 区域叠加与splitDockWidget的拆分逻辑

四个区域只是粗粒度划分。同一个区域里可以放多个 QDockWidget，它们会按添加顺序堆叠或者并排。默认情况下，后添加的会叠在已有窗口上面，形成标签页效果。如果你希望它们并排显示，就需要用splitDockWidget(first, second, orientation)。

mainWindow->addDockWidget(Qt::RightDockWidgetArea, dockA); mainWindow->splitDockWidget(dockA, dockB, Qt::Vertical);

这段代码的意思是：dockA 已经在右侧，现在把 dockB 放在 dockA 的下方（垂直方向拆分）。Qt::Vertical表示沿垂直方向分割，也就是上下排列；Qt::Horizontal则是左右排列。很多人第一次用会搞反，记住一个口诀：参数里的方向指的是“分割线的方向”。垂直分割线把区域分成左右两块，水平分割线分成上下两块。所以Qt::Vertical得到上下布局，Qt::Horizontal得到左右布局。

实际布局设计时，我通常先把所有停靠窗口按逻辑分组。比如“属性”和“历史记录”都属于检查类，放右侧上下拆分；“工具箱”和“图层”都属于资源类，放左侧上下拆分；“日志”放底部。分组之后再用 splitDockWidget 调整相对位置，比一个个 add 然后靠拖拽调整要可控得多。

2.3 初始尺寸与resizeDocks的配合

停靠窗口的初始大小是个容易踩坑的地方。你直接对 QDockWidget 调resize()往往不生效，因为它的尺寸由 QMainWindow 的布局系统接管。正确做法是用QMainWindow::resizeDocks()：

QList<QDockWidget*> rightDocks = {propertyDock, historyDock}; QList<int> sizes = {300, 200}; mainWindow->resizeDocks(rightDocks, sizes, Qt::Vertical);

resizeDocks接收一组停靠窗口、一组尺寸和方向。方向要和它们实际的排列方向一致，否则尺寸分配会乱。这个函数在窗口第一次显示之前调用效果最好，显示之后再调用可能需要配合update()或者等布局稳定。

我个人的经验是：初始尺寸不要设得太死。用户屏幕分辨率千差万别，你设 300 像素宽，在 4K 屏上可能窄得没法看，在 1366 屏上又占掉一大半。更稳妥的做法是给一个合理的最小宽度，然后让布局自适应。QDockWidget 本身有setMinimumWidth()和setMinimumHeight()，配合主窗口的初始尺寸，基本能保证开箱可用。

2.4 中央区域与停靠区域的优先级

QMainWindow 的布局有个隐含规则：中央区域优先占据剩余空间，停靠区域围绕它分布。如果你把停靠窗口设得很大，中央区域会被压缩。这时候用户拖拽分割条时，中央区域的最小尺寸由 centralWidget 的minimumSizeHint()决定。所以如果你发现中央区域被压得没法用，先检查 centralWidget 有没有设置合理的最小尺寸。

另外，四个停靠区域并不是必须都用上。有些软件只用左右两侧，底部和顶部留空。这完全没问题，QMainWindow 不会强制你填满。但要注意，如果某个区域没有任何停靠窗口，用户拖拽时那个区域不会出现放置提示，体验上会显得“这里不能放”。如果你希望用户能把面板拖到顶部，哪怕初始没有顶部面板，也可以先放一个隐藏的占位停靠窗口，或者接受这个限制。

3. 让面板“听话”：浮动、关闭与特性开关的精细控制

3.1setFeatures决定用户能对面板做什么

QDockWidget 提供了一组特性开关，通过setFeatures()组合设置。默认情况下，所有特性都是开启的，包括可关闭、可移动、可浮动。但在实际项目中，并不是每个面板都应该拥有全部能力。

dock->setFeatures(QDockWidget::DockWidgetClosable | QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetFloatable);

这三个是最常用的。DockWidgetClosable让面板右上角出现关闭按钮；DockWidgetMovable允许用户拖动面板到其他区域；DockWidgetFloatable允许面板脱离主窗口变成独立小窗。如果你希望某个面板固定不动，比如一个必须常驻的工具栏，就把 Movable 和 Floatable 去掉，只留 Closable 或者干脆全去掉。

这里有个实际项目中的教训：不要给所有面板都开 Floatable。浮动窗口在有些操作系统上会带来焦点管理和层级问题，尤其是多显示器环境下，用户把面板拖到副屏后可能找不到。对于辅助性面板，我通常保留 Movable 和 Closable，关掉 Floatable，让它们始终在主窗口范围内活动。只有那些用户确实需要“拿出来对照”的面板，比如参考图、颜色拾取器，才开启浮动。

3.2 标题栏与自定义标题控件

QDockWidget 的标题栏默认显示窗口标题和一个关闭按钮。你可以用setWindowTitle()设置标题文字，也可以用setTitleBarWidget()完全替换标题栏。后者在需要自定义按钮、图标或者特殊交互时很有用。

QWidget *customTitleBar = new QWidget; QHBoxLayout *layout = new QHBoxLayout(customTitleBar); layout->addWidget(new QLabel("图层")); QToolButton *menuBtn = new QToolButton; menuBtn->setText("..."); layout->addWidget(menuBtn); dock->setTitleBarWidget(customTitleBar);

替换标题栏之后，原本的关闭按钮和浮动按钮就没了，你需要自己在自定义控件里实现这些功能。这给了很大的自由度，但也意味着你要处理好拖拽逻辑——默认的标题栏拖拽移动面板的行为不会自动继承。如果自定义标题栏里没有处理鼠标事件，用户就没法拖动面板了。所以除非有明确的设计需求，否则不建议轻易替换标题栏。

3.3 可见性控制与toggleViewAction

控制停靠窗口显示和隐藏，最直接的是show()和hide()。但更优雅的方式是用toggleViewAction()：

QAction *toggleAction = dock->toggleViewAction(); menuBar->addAction(toggleAction);

这个 Action 自带勾选状态，文字就是停靠窗口的标题，用户点击就能切换显示隐藏，而且勾选状态会自动同步。把它加到“视图”菜单里，就得到了专业软件里常见的“面板显示/隐藏”菜单项。这个功能几乎零成本，但体验提升很明显，强烈建议每个 QDockWidget 都配上。

需要注意的是，toggleViewAction()返回的 Action 文本默认是停靠窗口的 windowTitle。如果你在标题里加了“面板”之类的后缀，菜单里也会带上。想要更简洁的菜单文字，可以手动setText()覆盖，但勾选同步依然有效。

3.4 浮动窗口的几何状态与topLevelChanged

当用户把停靠窗口拖出来变成浮动状态时，topLevelChanged(bool)信号会发出。你可以连接这个信号做一些额外处理，比如浮动时改变面板内容布局，或者记录浮动位置。

connect(dock, &QDockWidget::topLevelChanged, this, [dock](bool floating) { if (floating) { dock->setMinimumSize(400, 300); } else { dock->setMinimumSize(0, 0); } });

浮动窗口的初始位置和大小由系统决定，通常就在主窗口附近。如果你希望浮动时出现在特定位置，可以在信号里调用move()和resize()。但要注意，不同窗口管理器对浮动窗口的约束不同，强行设置位置可能被忽略。我的建议是：浮动窗口的尺寸给一个合理的最小值即可，位置交给系统，用户自己会调整。

还有一个细节：浮动窗口关闭时，默认行为是隐藏而不是销毁。如果你希望关闭即销毁，需要设置Qt::WA_DeleteOnClose属性，但这样下次就没法通过 toggleViewAction 重新显示了。所以通常还是保持隐藏语义，配合 toggleViewAction 做显示切换。

4. 布局持久化：saveState与restoreState的实战细节

4.1 状态保存的基本流程

QMainWindow 的saveState()返回一个 QByteArray，里面包含了所有停靠窗口和工具栏的位置、大小、可见性信息。配合saveGeometry()保存主窗口自身的位置和尺寸，就能完整还原用户上次的界面布局。

void MainWindow::closeEvent(QCloseEvent *event) { QSettings settings("MyCompany", "MyApp"); settings.setValue("geometry", saveGeometry()); settings.setValue("windowState", saveState()); QMainWindow::closeEvent(event); } void MainWindow::readSettings() { QSettings settings("MyCompany", "MyApp"); restoreGeometry(settings.value("geometry").toByteArray()); restoreState(settings.value("windowState").toByteArray()); }

这段代码是标准写法，但有几个坑必须注意。

4.2 版本兼容：restoreState的版本参数

restoreState()有一个可选参数version，默认是 0。如果你在后续版本中增删了停靠窗口，旧的状态数据可能无法正确恢复，甚至导致布局错乱。解决办法是给状态数据加一个版本号：

static const int LayoutVersion = 2; // 保存时 settings.setValue("windowState", saveState(LayoutVersion)); // 恢复时 QByteArray state = settings.value("windowState").toByteArray(); if (!restoreState(state, LayoutVersion)) { // 恢复失败，使用默认布局 createDefaultLayout(); }

当版本号不匹配时，restoreState返回 false，你就可以回退到默认布局。这个机制在软件升级时特别重要，否则用户升级后可能发现面板全乱了。

4.3 对象名：restoreState的匹配依据

saveState和restoreState靠什么匹配停靠窗口？答案是objectName。QMainWindow 内部用 objectName 来标识每个停靠窗口和工具栏。如果你没有给 QDockWidget 设置 objectName，Qt 会自动生成一个，但这个自动生成的名字在不同运行实例之间可能不一致，导致恢复失败。

所以务必给每个 QDockWidget 设置唯一的 objectName：

dock->setObjectName("propertyDock");

这个细节在文档里提得不多，但实际项目中如果不设置，布局恢复时灵时不灵，排查起来很头疼。我现在的习惯是：创建 QDockWidget 之后第一件事就是 setObjectName，名字用英文、唯一、语义清晰。

4.4 恢复时机与restoreState的调用位置

restoreState必须在所有停靠窗口都创建并 add 到 QMainWindow 之后调用。如果你在构造函数里先 restoreState 再创建面板，恢复必然失败。正确的顺序是：创建 centralWidget → 创建所有 QDockWidget → addDockWidget → 设置 objectName → 最后 restoreState。

另外，restoreGeometry和restoreState的调用时机也有讲究。如果主窗口还没显示就调用，某些平台下尺寸计算可能不准。我通常在主窗口构造函数末尾调用，或者在showEvent里做一次性的恢复。如果发现恢复后窗口位置偏了，可以尝试在show()之后用QTimer::singleShot(0, ...)延迟恢复。

4.5 默认布局与“重置布局”功能

用户把布局搞乱之后，通常需要一个“恢复默认布局”的入口。实现方式很简单：先隐藏所有停靠窗口，然后重新按默认位置 add 和 split，最后 show 出来。

void MainWindow::resetLayout() { for (QDockWidget *dock : allDocks) { dock->hide(); } addDockWidget(Qt::RightDockWidgetArea, propertyDock); addDockWidget(Qt::RightDockWidgetArea, historyDock); splitDockWidget(propertyDock, historyDock, Qt::Vertical); // ... 其他面板 for (QDockWidget *dock : allDocks) { dock->show(); } }

注意这里不需要 removeDockWidget，直接重新 add 会覆盖之前的位置。但如果有 splitDockWidget 的拆分关系，重新 add 之后可能需要重新 split。实测下来，先 hide 再 add 再 show 是最稳的流程。

5. 那些文档不会告诉你的坑与应对经验

5.1 停靠窗口内的控件尺寸异常

QDockWidget 作为容器，里面的控件有时候会出现尺寸不听话的情况。比如你放一个 QTreeWidget，希望它填满整个停靠窗口，但实际显示时只占了上半部分。这通常是因为 QDockWidget 的布局没有正确设置，或者内部控件的 sizePolicy 不对。

解决办法是给 QDockWidget 设置一个中间 QWidget 作为容器，用 QVBoxLayout 管理，并确保 layout 的 margin 和 spacing 合理：

QWidget *container = new QWidget; QVBoxLayout *layout = new QVBoxLayout(container); layout->setContentsMargins(0, 0, 0, 0); layout->setSpacing(0); layout->addWidget(treeWidget); dock->setWidget(container);

直接dock->setWidget(treeWidget)也可以，但套一层容器更灵活，后续要加工具栏或状态栏也方便。setContentsMargins(0,0,0,0)能去掉默认边距，让内容真正贴边。

5.2 拖拽时的视觉反馈与allowedAreas

setAllowedAreas()可以限制停靠窗口只能放在哪些区域。比如一个日志窗口只允许放底部和顶部，不允许放左右：

dock->setAllowedAreas(Qt::BottomDockWidgetArea | Qt::TopDockWidgetArea);

设置之后，用户拖拽时其他区域不会出现放置提示，面板会自动吸附到允许的区域。这个功能在多面板布局里很有用，能防止用户把不合适的 panel 放到奇怪的位置。

但要注意，allowedAreas和features是两回事。allowedAreas限制的是“能放哪”，features限制的是“能不能动”。如果 features 里没有 Movable，allowedAreas 设了也没用，因为用户根本拖不动。

5.3 多显示器下的浮动窗口丢失

前面提到过，浮动窗口在多显示器环境下可能跑到副屏去。如果用户拔掉副屏，浮动窗口就可能出现在屏幕外，找不回来。应对方法是在恢复布局时检查浮动窗口的位置是否在可见屏幕范围内：

QRect screenGeometry = QApplication::primaryScreen()->availableGeometry(); if (!screenGeometry.intersects(dock->frameGeometry())) { dock->move(screenGeometry.center()); }

这段逻辑可以放在restoreState之后执行。虽然不能覆盖所有情况，但至少能避免窗口完全不可见。更完善的做法是遍历所有屏幕，判断窗口是否与任一屏幕相交。

5.4 样式定制：标题栏与分割条

QDockWidget 的标题栏和分割条样式可以通过 QSS 定制。比如去掉标题栏背景、改变关闭按钮图标、调整分割条宽度：

QDockWidget { titlebar-close-icon: url(:/icons/close.svg); titlebar-normal-icon: url(:/icons/float.svg); } QDockWidget::title { background: #f0f0f0; padding: 4px; } QMainWindow::separator { width: 4px; height: 4px; background: #d0d0d0; }

QMainWindow::separator控制的是停靠区域之间的分割条。默认分割条很细，鼠标不好抓，适当加宽能提升体验。但也不要太宽，否则视觉上显得笨重。4 到 6 像素是比较合适的范围。

5.5 性能考量：停靠窗口数量与重绘

停靠窗口本身不重，但每个窗口里的控件如果很复杂，比如大型表格、树形视图、图表，数量多了之后窗口缩放和拖拽会变卡。我做过一个项目，主窗口挂了八个停靠窗口，每个里面都有独立的模型视图，拖拽分割条时明显掉帧。

优化思路有几个：一是延迟创建，面板不可见时不创建内部控件，等第一次 show 的时候再初始化；二是共享模型，多个视图共用同一个数据模型，减少内存和信号开销；三是限制同时可见的面板数量，通过 toggleViewAction 让用户按需开启。这些手段组合起来，基本能保证流畅度。

5.6 与 QToolBar 的配合

QMainWindow 除了停靠窗口，还支持工具栏。工具栏也可以停靠在四个区域，也可以浮动。实际布局中，工具栏通常放顶部，停靠窗口放两侧和底部。两者可以共存，但要注意空间分配。如果顶部工具栏很多，中央区域会被压缩，这时候可以考虑把部分工具栏做成停靠窗口，或者用addToolBarBreak()换行。

工具栏和停靠窗口的状态都会被saveState保存，所以恢复布局时两者一起还原，不需要分开处理。这也是 QMainWindow 布局系统的一个便利之处。

6. 一个可复用的布局骨架：从零搭一个多面板编辑器界面

6.1 整体结构设计

假设我们要做一个简易的图形编辑器，界面需求是：中央是画布，左侧是工具箱和图层面板，右侧是属性面板和历史记录，底部是日志输出。这个布局用 QDockWidget 实现起来很直接。

先规划 objectName 和区域：

6.2 创建与布局代码

void MainWindow::createDocks() { // 工具箱 toolboxDock = new QDockWidget("工具箱", this); toolboxDock->setObjectName("toolboxDock"); toolboxDock->setWidget(createToolboxWidget()); toolboxDock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea); addDockWidget(Qt::LeftDockWidgetArea, toolboxDock); // 图层面板 layerDock = new QDockWidget("图层", this); layerDock->setObjectName("layerDock"); layerDock->setWidget(createLayerWidget()); addDockWidget(Qt::LeftDockWidgetArea, layerDock); splitDockWidget(toolboxDock, layerDock, Qt::Vertical); // 属性面板 propertyDock = new QDockWidget("属性", this); propertyDock->setObjectName("propertyDock"); propertyDock->setWidget(createPropertyWidget()); propertyDock->setFeatures(QDockWidget::DockWidgetClosable | QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetFloatable); addDockWidget(Qt::RightDockWidgetArea, propertyDock); // 历史记录 historyDock = new QDockWidget("历史记录", this); historyDock->setObjectName("historyDock"); historyDock->setWidget(createHistoryWidget()); addDockWidget(Qt::RightDockWidgetArea, historyDock); splitDockWidget(propertyDock, historyDock, Qt::Vertical); // 日志输出 logDock = new QDockWidget("日志", this); logDock->setObjectName("logDock"); logDock->setWidget(createLogWidget()); logDock->setAllowedAreas(Qt::BottomDockWidgetArea | Qt::TopDockWidgetArea); addDockWidget(Qt::BottomDockWidgetArea, logDock); // 初始尺寸 resizeDocks({toolboxDock, layerDock}, {200, 300}, Qt::Vertical); resizeDocks({propertyDock, historyDock}, {300, 200}, Qt::Vertical); resizeDocks({logDock}, {150}, Qt::Vertical); }

这段代码里，工具箱和图层面板在左侧上下排列，属性面板和历史记录在右侧上下排列，日志在底部。resizeDocks给每个面板一个初始高度或宽度，避免启动时挤成一团。

6.3 视图菜单与状态恢复

void MainWindow::createViewMenu() { QMenu *viewMenu = menuBar()->addMenu("视图"); viewMenu->addAction(toolboxDock->toggleViewAction()); viewMenu->addAction(layerDock->toggleViewAction()); viewMenu->addAction(propertyDock->toggleViewAction()); viewMenu->addAction(historyDock->toggleViewAction()); viewMenu->addAction(logDock->toggleViewAction()); viewMenu->addSeparator(); QAction *resetAction = viewMenu->addAction("重置布局"); connect(resetAction, &QAction::triggered, this, &MainWindow::resetLayout); }

每个面板的 toggleViewAction 自动带上勾选状态和标题文字，用户点一下就能开关。重置布局的 Action 调用前面写的 resetLayout 函数。

状态保存和恢复放在 closeEvent 和构造函数里，配合 objectName 和版本号，基本能做到“用户怎么摆，下次就怎么开”。

6.4 实测中的小问题与调整

实际跑起来之后，我发现两个需要微调的地方。第一，左侧工具箱的初始宽度 200 在 1080p 屏幕上偏窄，里面的图标按钮换行显示很难看，改成 240 之后舒服很多。第二，底部日志面板在窗口高度较小时会挤压中央画布，给 logDock 设置setMinimumHeight(100)之后，画布至少能保留可用空间。

另外，resizeDocks在窗口第一次 show 之前调用效果最好。如果放在 show 之后，可能需要等一帧布局稳定。我的做法是在构造函数里创建完所有面板后立即调用 resizeDocks，然后 show 主窗口，实测位置和尺寸都符合预期。

还有一个体验优化：给每个 QDockWidget 的标题栏加一个图标，用setWindowIcon()设置。这样在标签页模式下（多个面板叠在一起时），用户能通过图标快速识别。图标尺寸建议 16x16，和标题栏高度匹配。

7. 从能用走向好用：几个提升体验的进阶思路

7.1 标签页化与tabifyDockWidget

当同一区域有多个面板时，默认是堆叠显示，但用户可以通过拖拽把它们变成标签页。你也可以主动调用tabifyDockWidget(first, second)把两个面板合并成标签页：

tabifyDockWidget(propertyDock, historyDock); propertyDock->raise();

tabifyDockWidget把第二个面板以标签页形式放到第一个面板上，raise()让指定面板显示在最前面。这样右侧区域就变成一个带两个标签的容器，节省空间。用户点击标签切换，也可以拖出来重新变成独立面板。

标签页模式在面板数量多、屏幕空间有限时特别有用。我通常会把逻辑上相关的面板 tabify 在一起，比如“属性”和“历史”、“图层”和“通道”。这样默认布局更紧凑，用户需要时再展开。

7.2 自定义浮动行为与dockLocationChanged

dockLocationChanged(Qt::DockWidgetArea)信号在面板停靠位置变化时发出。你可以利用这个信号做上下文相关的调整，比如面板从右侧移到左侧时，内部控件的布局方向也跟着变。

connect(dock, &QDockWidget::dockLocationChanged, this, [dock](Qt::DockWidgetArea area) { bool horizontal = (area == Qt::LeftDockWidgetArea || area == Qt::RightDockWidgetArea); // 根据方向调整内部布局 });

这个信号在实现响应式面板时很有价值。比如一个工具栏面板，竖着放时按钮垂直排列，横着放时按钮水平排列。虽然 QDockWidget 本身不自动做这个，但通过信号手动调整并不复杂。

7.3 面板内容的懒加载

前面提过性能问题，懒加载是有效的应对手段。思路是：QDockWidget 创建时只放一个占位 QWidget，等第一次showEvent或者visibilityChanged(true)时再创建真正的内部控件。

connect(dock, &QDockWidget::visibilityChanged, this, [this, dock](bool visible) { if (visible && !dock->widget()) { dock->setWidget(createHeavyWidget()); } });

这样启动时只创建可见的面板，隐藏的面板不占用初始化时间。对于面板多、内部控件重的项目，启动速度能明显提升。代价是第一次显示时可能有短暂延迟，可以通过预加载最常用的面板来平衡。

7.4 键盘快捷键与面板切换

给 toggleViewAction 设置快捷键，用户就能用键盘快速开关面板：

toolboxDock->toggleViewAction()->setShortcut(QKeySequence("Ctrl+1")); propertyDock->toggleViewAction()->setShortcut(QKeySequence("Ctrl+2"));

这种快捷键在专业软件里很常见，熟练用户几乎不用鼠标就能组织界面。快捷键的选择要避开常用编辑操作的组合，Ctrl+数字键是比较安全的选择。

7.5 状态栏提示与拖拽引导

当用户拖拽面板时，可以在状态栏显示当前可放置的区域提示。虽然 Qt 自带拖拽视觉反馈，但额外的文字提示对新手更友好。实现方式是在topLevelChanged和dockLocationChanged信号里更新状态栏文字。

这个细节不是必须的，但在面向非专业用户的软件里，能降低学习成本。我自己用下来，加了提示之后，用户误操作的概率确实会低一些。

8. 写在最后：一些个人体会

QDockWidget 这个控件，刚接触时觉得很简单，无非就是 add 几个面板。但真正在项目里用起来，才发现细节很多：objectName 忘了设导致布局恢复失败、resizeDocks 方向搞反、浮动窗口跑到屏幕外、面板多了之后拖拽卡顿。这些问题文档里不会专门讲，只有踩过才知道。

我的建议是，如果你准备在项目里用 QDockWidget，先把状态保存和恢复的流程跑通，再逐步加面板。每加一个面板就设好 objectName、allowedAreas 和 features，不要等到最后再补。布局这东西，一开始规整，后面就省心；一开始凑合，后面就是无尽的调整。

另外，不要过度设计。不是所有面板都需要浮动，不是所有区域都需要填满。根据实际使用频率来决定哪些面板常驻、哪些可关闭、哪些默认隐藏。用户真正需要的，是一个打开就能用的界面，而不是一个需要自己配置半天才能干活的界面。