企业官网建设流程全解析

1. 背景

1.1 为什么需要Qt Widgets

Qt 提供了三套 UI 技术栈：Qt Widgets（命令式、面向对象、控件驱动）、Qt Quick/QML（声明式、GPU 场景图）、以及底层绘制 API（QPainter、Graphics View）。对于工业上位机、桌面工具、设备配置软件这类「以控件密集、表单复杂、需要成熟交互控件」为特征的应用，Qt Widgets 至今仍是主力选择。

然而 Widgets 看似简单（拖几个控件就能跑），一旦进入真实工程就会遇到一系列问题：

• 控件"布局"为什么时灵时不灵？setFixedSize 与 setMinimumSize 与 setSizePolicy 到底谁说了算？
• 窗口拉伸时，为什么按钮没有按预期等比放大？
• 同一个 QLineEdit，为什么有的机器上高度对不齐？
• 样式表（QSS）写了不生效，或者局部生效？
• 在 Qt 系列教程里，信号槽、Model/View、QPainter、Graphics View、QML 都各有专篇，唯独"控件本体与布局体系"缺少系统梳理。

本篇专门填补这一空白：围绕QWidget 类层次 → 布局管理器 → 尺寸策略 → 常用控件 API → QSS 样式 → 事件与绘制构建一条完整主线，并给出可编译示例、底层实现剖析、常错点与 FAQ。

1.2 适用场景

• 工业上位机/HMI（设备状态面板、参数配置表单、报警列表）
• 桌面工具类应用（配置器、采集器界面、监控面板）
• 控件密集型 CRUD 界面（表格 + 表单 + 对话框）

1.3 技术选型：Widgets vs QML

真实工程常用混合策略：主体 Widgets + 局部 QML（QQuickWidget 嵌入）取两者之长。

2. 核心概念速览

2.1 QObject 与 QWidget 类层次

QObject └── QWidget ← 所有控件的基类（窗口 + 控件二合一） ├── QFrame │ ├── QLabel │ ├── QAbstractScrollArea │ │ ├── QTextEdit / QPlainTextEdit │ │ ├── QScrollArea │ │ └── QAbstractItemView (QListView/QTableView/QTreeView) │ └── QAbstractButton │ ├── QPushButton / QToolButton / QCheckBox / QRadioButton ├── QAbstractSlider (QSlider/QScrollBar/QDial) ├── QAbstractSpinBox (QSpinBox/QDoubleSpinBox) ├── QLineEdit ├── QComboBox ├── QAbstractItemView 便捷类: QListWidget/QTableWidget/QTreeWidget ├── QGroupBox / QTabWidget / QToolBox / QStackedWidget └── 容器: QWidget(裸容器) / QSplitter / QScrollArea / QMainWindow / QDialog

关键认知：QWidget 同时是"控件"和"窗口"。任何 QWidget 都可以脱离父窗口独立显示（成为顶层窗口，只要不设 parent）；顶层窗口默认带标题栏，Qt::WA_DeleteOnClose 等窗口属性在此基础上生效。

2.2 父对象（Parent）与所有权

• 子控件必须指定 parent（new QLabel(parent)），或事后 setParent()；
• 父对象负责销毁子对象：parent 析构时递归删除所有子控件（Qt 对象树机制）；
• 布局管理器会把控件"reparent"到布局所属的容器上（layout->addWidget(w) 等价于把 w 的 parent 设为容器），因此不需要同时手动 setParent 与 addWidget；
• 千万不能 new 一个控件又不给 parent 又忘记 delete——要么给 parent，要么自己管理内存。

2.3 几何模型：pos / size / geometry / frameGeometry

⚠️ 手写 resize/move 与布局管理器是互斥思路：布局接管后手动几何设置会被布局下一轮覆盖（见第 5 章）。

2.4 布局管理器（QLayout）体系

QLayout ├── QBoxLayout │ ├── QHBoxLayout（水平） │ └── QVBoxLayout（垂直） ├── QGridLayout（网格：行列 + 跨行跨列） ├── QFormLayout（表单：label + field 两列） ├── QStackedLayout（页切换） └── QSplitter（分割器，本质是带交互手柄的特殊布局）

核心职责：在容器 resize 时自动计算每个子控件的几何，依据每个控件的 sizeHint、minimumSizeHint、sizePolicy、stretch 与间距/边距。

2.5 尺寸策略（QSizePolicy）

这是 Widgets 布局最核心也最被误解的概念。每个控件有水平/垂直两个方向的策略，取值：

判断规则（直觉版）：

• 默认控件策略多为 Preferred——不会主动抢占额外空间；
• 想让控件随窗口拉伸而"变大"，必须 Expanding/MinimumExpanding（或设置 stretch 因子）；
• 想让控件"锁死"尺寸，用 Fixed 或 setFixedSize（二者等价效果，但 setFixedSize 会同时锁定 min/max）。

3. API 说明与速查

3.1 QWidget 通用 API（高频）

// 尺寸与几何 w->setFixedSize(200, 40); // 锁定尺寸（min==max==指定值） w->setMinimumSize(100, 30); // 最小 w->setMaximumSize(500, 200); // 最大 w->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed); // 水平可扩展，垂直固定 w->sizeHint(); // 首选尺寸（控件自己"想要"多大） w->minimumSizeHint(); // 最小可接受尺寸 w->adjustSize(); // 按 sizeHint 自适应 w->setEnabled(bool); // 禁用（变灰且不响应） w->setVisible(bool); // 显示/隐藏 w->isVisible(); // 是否（对父链也）可见 w->show(); w->hide(); // 便捷方法 w->setToolTip(QString); // 悬停提示 w->setWhatsThis(QString); // 帮助提示 w->setFocusPolicy(Qt::StrongFocus); // 焦点策略 w->setAttribute(Qt::WA_DeleteOnClose); // 关闭时自毁 w->update(); // 触发重绘（异步，合并） w->repaint(); // 立即重绘（慎用，可能闪烁）

3.2 布局 API

// 创建容器并设置布局 auto *form = new QWidget; auto *lay = new QVBoxLayout(form); // 一步完成：创建 + 安装到 form // 或 auto *lay = new QVBoxLayout; form->setLayout(lay); // 常用方法 lay->addWidget(w); // 添加控件 lay->addLayout(subLayout); // 嵌套布局 lay->addStretch(); // 弹簧（占位伸缩项） lay->addSpacing(10); // 固定间距 lay->addItem(new QSpacerItem(20, 20, QSizePolicy::Expanding, QSizePolicy::Minimum)); lay->setSpacing(6); // 控件间距 lay->setContentsMargins(9, 9, 9, 9); // 外边距（left, top, right, bottom） lay->setAlignment(w, Qt::AlignHCenter); // 单个控件对齐 lay->removeWidget(w); // 移除（不 delete） lay->insertWidget(index, w); // 指定位置插入

QGridLayout 进阶：

grid->addWidget(w, row, col); // 单元格 grid->addWidget(w, row, col, rowSpan, colSpan); // 跨行跨列 grid->addLayout(lay, row, col); grid->setColumnStretch(0, 1); // 第 0 列 stretch=1 grid->setRowStretch(2, 2); // 第 2 行 stretch=2 grid->setColumnMinimumWidth(0, 80); grid->setRowMinimumHeight(0, 30);

QFormLayout：

auto *form = new QFormLayout; form->addRow("名称:", new QLineEdit); form->addRow("类型:", new QComboBox); form->addRow(new QPushButton("提交")); // 跨两列 form->setLabelAlignment(Qt::AlignRight); form->setFieldGrowthPolicy(QFormLayout::AllNonFixedFieldsGrow);

3.3 常用控件 API 速查

3.4 窗口体系：QMainWindow / QDialog

• QMainWindow：主窗口骨架，有中央区 + 菜单栏 + 工具栏 + 状态栏 + 停靠区（QDockWidget）；中央区必须 setCentralWidget；
• QDialog：对话框基类，exec() 模态运行返回 QDialog::Accepted/Rejected，accept()/reject()/done(int) 结束；setModal(true) 或 exec() 自带模态；
• 顶层 QWidget 也可当窗口用，但没有菜单栏/状态栏便利设施。

3.5 QSS（Qt Style Sheets）

语法与 CSS2 高度相似，选择器 + 声明块：

// 全局样式表 qApp->setStyleSheet( "QPushButton { background: #2d6cdf; color: white; border-radius: 4px; padding: 6px 12px; }" "QPushButton:hover { background: #3a7bfd; }" "QPushButton:pressed { background: #1e56b8; }" "QLineEdit:focus { border: 2px solid #2d6cdf; }" "QGroupBox#devicePanel { border: 1px solid #cccccc; margin-top: 12px; }" ); // 对象名选择器（推荐）: 先给控件 setObjectName auto *btn = new QPushButton("启动"); btn->setObjectName("startBtn");

选择器要点：类型选择器 QPushButton、对象名 #name、属性 QPushButton[checkable="true"]、后代 QWidget QLineEdit、子对象 QGroupBox > QLineEdit、伪状态 :hover/:pressed/:checked/:disabled/:focus、动态属性 [state="ok"]（需 style()->unpolish/polish 刷新）。

4. 详细使用说明（可编译示例）

4.1 最小可运行程序：布局 + 尺寸策略

#include <QApplication> #include <QWidget> #include <QVBoxLayout> #include <QHBoxLayout> #include <QPushButton> #include <QLineEdit> #include <QLabel> #include <QTextEdit> int main(int argc, char *argv[]) { QApplication app(argc, argv); auto *window = new QWidget; window->setWindowTitle("Widgets 布局示例"); window->resize(420, 320); auto *root = new QVBoxLayout(window); // 顶部：输入行 auto *inputRow = new QHBoxLayout; inputRow->addWidget(new QLabel("命令:")); auto *edit = new QLineEdit; edit->setPlaceholderText("输入内容..."); inputRow->addWidget(edit, 1); // stretch=1：edit 抢占水平额外空间 auto *goBtn = new QPushButton("执行"); inputRow->addWidget(goBtn); // 默认 Preferred，不抢空间 root->addLayout(inputRow); // 中部：日志区（Expanding：窗口拉伸时跟随变大） auto *log = new QTextEdit; log->setReadOnly(true); log->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding); root->addWidget(log, 1); // stretch=1：垂直抢额外空间 // 底部：固定按钮行 auto *bottomRow = new QHBoxLayout; bottomRow->addStretch(1); // 弹簧把按钮推到右侧 auto *cancelBtn = new QPushButton("取消"); auto *okBtn = new QPushButton("确定"); bottomRow->addWidget(cancelBtn); bottomRow->addWidget(okBtn); root->addLayout(bottomRow); window->show(); return app.exec(); }

要点：addWidget(w, 1) 的 1 是 stretch 因子，stretch 是布局分配额外空间的最强杠杆，比 sizePolicy 更容易理解和使用——两者叠加时以"谁更贪婪"为准（见 5.2）。

4.2 网格布局：参数配置表单

auto *grid = new QGridLayout; grid->setSpacing(8); grid->setContentsMargins(12, 12, 12, 12); auto *nameEdit = new QLineEdit; auto *ipEdit = new QLineEdit; auto *portSpin = new QSpinBox; portSpin->setRange(0, 65535); portSpin->setValue(502); grid->addWidget(new QLabel("设备名称:"), 0, 0); grid->addWidget(nameEdit, 0, 1); grid->addWidget(new QLabel("IP 地址:"), 1, 0); grid->addWidget(ipEdit, 1, 1); grid->addWidget(new QLabel("端口:"), 2, 0); grid->addWidget(portSpin, 2, 1); // 让第 1 列（输入区）随窗口拉伸 grid->setColumnStretch(1, 1); // 按钮行跨两列 auto *saveBtn = new QPushButton("保存"); grid->addWidget(saveBtn, 3, 0, 1, 2, Qt::AlignRight);

4.3 便捷表格控件：QTableWidget 增删行

auto *table = new QTableWidget; table->setColumnCount(4); table->setHorizontalHeaderLabels({"点位", "值", "单位", "时间"}); table->setSelectionBehavior(QAbstractItemView::SelectRows); // 整行选中 table->setEditTriggers(QAbstractItemView::NoEditTriggers); // 只读 auto addRow = [&](const QString &point, double value, const QString &unit) { int row = table->rowCount(); table->insertRow(row); table->setItem(row, 0, new QTableWidgetItem(point)); table->setItem(row, 1, new QTableWidgetItem(QString::number(value))); table->setItem(row, 2, new QTableWidgetItem(unit)); table->setItem(row, 3, new QTableWidgetItem( QDateTime::currentDateTime().toString("hh:mm:ss"))); }; addRow("CNC_SPEED", 1200.5, "rpm"); addRow("CNC_LOAD", 85.3, "%"); table->resizeColumnsToContents();

4.4 表单 + 分组 + 选项卡组合（工业配置面板骨架）

auto *panel = new QWidget; auto *root = new QVBoxLayout(panel); auto *tabs = new QTabWidget; // 页1：连接参数（QFormLayout） auto *connPage = new QWidget; auto *form = new QFormLayout(connPage); form->addRow("IP:", new QLineEdit("192.168.1.10")); form->addRow("端口:", new QSpinBox); tabs->addTab(connPage, "连接"); // 页2：采集参数（分组框） auto *acqPage = new QWidget; auto *acqLay = new QVBoxLayout(acqPage); auto *grp = new QGroupBox("采样设置"); grp->setCheckable(true); grp->setChecked(true); auto *grpLay = new QVBoxLayout(grp); grpLay->addWidget(new QCheckBox("启用实时采集")); grpLay->addWidget(new QCheckBox("异常自动告警")); acqLay->addWidget(grp); acqLay->addStretch(); tabs->addTab(acqPage, "采集"); root->addWidget(tabs, 1); auto *btnRow = new QHBoxLayout; btnRow->addStretch(); btnRow->addWidget(new QPushButton("应用")); btnRow->addWidget(new QPushButton("确定")); root->addLayout(btnRow);

4.5 QSS 主题 + 动态属性刷新

qApp->setStyleSheet(R"( QWidget { font-family: "Microsoft YaHei"; font-size: 13px; } QLineEdit, QSpinBox, QComboBox { border: 1px solid #b8b8b8; border-radius: 3px; padding: 3px 6px; background: white; } QLineEdit:focus, QSpinBox:focus, QComboBox:focus { border: 1px solid #2d6cdf; } QTableWidget { gridline-color: #e0e0e0; alternate-background-color: #f5f7fa; } QPushButton#primary { background: #2d6cdf; color: white; } QPushButton#primary:hover { background: #3a7bfd; } )"); // 动态属性切换样式 auto *statusLabel = new QLabel("正常"); statusLabel->setProperty("state", "ok"); auto refreshStyle = [&](bool ok) { statusLabel->setProperty("state", ok ? "ok" : "error"); // 关键：动态属性变化后必须重新 polish，否则样式不刷新 statusLabel->style()->unpolish(statusLabel); statusLabel->style()->polish(statusLabel); statusLabel->update(); };

4.6 自定义控件：重写 paintEvent 的仪表卡片

class StatusCard : public QWidget { public: explicit StatusCard(const QString &title, QWidget *parent = nullptr) : QWidget(parent), m_title(title) { setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Preferred); setMinimumSize(120, 80); } protected: void paintEvent(QPaintEvent *) override { QPainter p(this); p.setRenderHint(QPainter::Antialiasing); // 卡片底色 QColor bg = m_ok ? QColor(0xe8, 0xf5, 0xe9) : QColor(0xfd, 0xec, 0xec); p.setBrush(bg); p.setPen(Qt::NoPen); p.drawRoundedRect(rect().adjusted(0, 0, -1, -1), 6, 6); // 标题 p.setPen(QColor(0x33, 0x33, 0x33)); QFont f = font(); f.setBold(true); p.setFont(f); p.drawText(QRect(8, 6, width()-16, 20), Qt::AlignLeft, m_title); // 状态文字 p.setPen(m_ok ? QColor(0x2e, 0x7d, 0x32) : QColor(0xc6, 0x28, 0x28)); f.setBold(false); p.setFont(f); p.drawText(rect().adjusted(8, 28, -8, -8), Qt::AlignCenter, m_ok ? "运行正常" : "异常停机"); } void setOk(bool ok) { m_ok = ok; update(); } private: QString m_title; bool m_ok = true; };

5. 底层实现剖析

5.1 QWidgetPrivate 与窗口系统抽象

QWidget 的实现核心是 QWidgetPrivate（PIMPL 模式）。QWidget::show() 最终调用 QWidgetPrivate::setVisible → 创建原生窗口（QPlatformWindow），Qt 通过QPA（Qt Platform Abstraction）插件层把控件映射到 Windows/WinAPI、X11、Wayland、macOS 等平台。控件自身的内存布局（child list、geometry、flags）与原生句柄分离：HWND 等原生窗口只在需要时创建（部分控件可"合并"到父窗口，减少句柄数，称为 native vs alien widgets——Windows 上默认 alien，大幅减少资源占用）。

5.2 布局引擎的几何传播算法

布局系统工作流程（resize 触发）：

1. 容器 resizeEvent → 容器 Layout 的 setGeometry；
2. 布局管理器读取每个子项的 sizeHint / minimumSizeHint / maximumSize / sizePolicy；
3. 计算"需求"：每项最小尺寸 = max(minimumSizeHint, sizePolicy 强制的 min)，首选尺寸 = sizeHint；
4. stretch 因子分配：额外空间 = 容器内容区尺寸 - 各项最小需求之和 - 间距边距；额外空间按 stretch 加权分配给 Expanding/MinimumExpanding 或 stretch>0 的项；
5. 若空间不足：优先收缩 Shrinkable 项（策略非 Fixed/Minimum 的项），仍不够则触发最小尺寸限制；
6. 递归处理嵌套布局，直到叶子控件，最终调用每个控件的 setGeometry。

QLayout 本身是抽象，真正干活的是 QBoxLayout 的 setGeometries/itemGeometry 等虚函数，逐项按 QGridLayout 的 grid 二维结构计算行列宽高。

5.3 sizePolicy 与 sizeHint 的组合公式

布局对某个方向（如水平）的处理等价于：

min_i = policy 允许的最小宽度（Fixed→w_hint；Preferred/Minimum→min_w；...） pref_i = w_hint（或 policy 修正后的首选） max_i = policy 允许的最大宽度（Fixed→w_hint；Expanding→∞；...） 实际宽度: 若 total_pref <= available: w_i = pref_i + extra_i（extra 按 stretch 分配，只给可增长项） 若 total_min <= available: 在 min 基础上分配差额 否则: 按 min 裁剪（控件可能被压到最小尺寸）

这解释了常见现象：默认 Preferred 策略的控件在窗口放大时保持 sizeHint 大小，额外空间被 stretch/Expanding 项吸收；若所有项都是 Preferred 且无 stretch，额外空间会被"闲置"在布局边缘或由布局的对齐属性决定位置。

5.4 QSS 样式表的解析与冲突

QSS 由 Qt 内部的样式引擎（QStyleSheetStyle，继承自 QCommonStyle）处理：样式表被解析成选择器规则树，控件在 polish() 时匹配规则、覆盖默认样式；绘制走 QStyleSheetStyle::drawPrimitive/drawControl，未匹配部分回退到平台样式（Fusion/Windows 等）。对象名与动态属性参与匹配；动态属性变化后必须 unpolish/polish 让规则重新计算。QSS 并非完整 CSS：不支持浮动/盒模型完整规范，支持的是 Qt 样式引擎的"子集 + 伪状态"。

6. 常错点/坑（20 条）

1. 不给 parent 的 new：控件泄漏或悬空；务必 parent 或手动管理。
2. 同时 setParent 与 addWidget：addWidget 会自动 reparent，重复设置一般无害但易混淆；不要在两处分别 delete。
3. 手写 resize/move 后又被布局覆盖：布局接管几何后，手写设置会被下一轮布局冲刷；想固定用 sizePolicy/stretch/Fixed。
4. 忘了 setCentralWidget：QMainWindow 直接 addWidget 到布局不生效——必须 setCentralWidget(w) 再给 w 设布局。
5. 布局被重复安装：setLayout 只能装一次；嵌套布局用 addLayout，不要在容器上再 setLayout。
6. sizePolicy 理解错误：Preferred 不会抢占空间，想要随窗口放大必须 Expanding + stretch。
7. setFixedSize 与 sizePolicy 冲突：Fixed 后 stretch 无效；改大小时先解除 fixed（setMinimumSize/setMaximumSize 恢复）。
8. QTableWidget 列宽不随窗口：默认列不自动拉伸，用 horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch) 或 Interactive。
9. 表格 item 悬空：setItem(row,col,new QTableWidgetItem(...)) 传栈对象或未 new 的指针会崩；必须 new（表接管所有权）。
10. QComboBox 数据混乱：addItem(text) 后 currentData() 是 QVariant()；需要 userData 用 addItem(text, QVariant::fromValue(id))。
11. QRadioButton 不互斥：同一父下多个 radio 默认互斥，但放到不同 GroupBox 后互相独立；跨组互斥需 QButtonGroup。
12. QSS 不生效：常见原因——写错对象名、控件在子类中样式被内联覆盖、动态属性未 polish、样式表字符串引号/分号错误。
13. QSS 影响性能：大表格大量控件用复杂 QSS 会拖慢；必要时只给关键控件设置样式（对象名选择器更精准）。
14. 中文乱码/字体缺失：Windows 上设置 QApplication::setFont(QFont("Microsoft YaHei"))；源码用 UTF-8 + QStringLiteral/u8 前缀（MSVC 需 /utf-8）。
15. UI 线程卡死：在槽里做耗时操作（读文件/网络/协议栈）导致界面无响应；耗时任务移线程/异步，结果通过信号回主线程。
16. 跨线程直接操作控件：子线程 setText/show 是未定义行为（崩溃或偶发）；用信号槽 QueuedConnection 或 QMetaObject::invokeMethod(..., Qt::QueuedConnection)。
17. 高 DPI 模糊：Qt5 需 QApplication::setHighDpiScaleFactorRoundingPolicy + 环境变量；Qt6 默认支持，但自定义 paintEvent 里要按 devicePixelRatio 处理。
18. paintEvent 里做重活：绘制中分配对象/加载图片会卡 UI；预处理缓存到成员，paintEvent 只做绘制。
19. deleteLater 与布局移除顺序：removeWidget 不 delete；想销毁用 delete w 或 w->deleteLater()，注意先从布局移除。
20. setEnabled(false) 后样式不更新：禁用态伪状态 :disabled 需要 QSS 定义，否则外观变化不明显，容易误判控件仍可用。

7. 性能与工程实践

7.1 控件数量与渲染性能

• QWidget 每个对象都有对象树/事件/布局开销，上千个控件的表单（如监控矩阵）可能卡顿；
• 大量同质数据展示优先 QTableWidget + 虚拟模式（setModel + 自定义模型，按需提供数据）或 QAbstractItemView 的 model/view 分离，避免逐个 new 控件；
• 频繁刷新的值显示用 QLabel 即可，避免用 QTextEdit/QTableWidget 高频 append（会触发重排版）。

7.2 布局性能

• 嵌套布局层级过深（5+ 层）在 resize 时会多次递归计算；能用 QGridLayout 一层的尽量一层；
• layout->setSizeConstraint(QLayout::SetFixedSize) 让窗口按内容自动定型，但动态增减控件后需重新 adjustSize；
• 隐藏/显示控件会触发布局重算，批量操作时先 setUpdatesEnabled(false)，完成后再恢复。

7.3 工程化建议

1. 用 .ui 文件（Qt Designer）+ uic：复杂界面先拖拽设计再代码微调，避免手写布局错误；
2. 控件统一 setObjectName：QSS 用对象名选择器，避免全局类型样式互相污染；
3. 界面代码与业务分离：Widget 子类只负责展示，数据经信号/模型注入；
4. 皮肤化：把 QSS 做成外部 .qss 文件运行时加载，便于换肤与现场调试；
5. 定时器驱动刷新节流：传感器等高频数据更新 UI 时按 100ms~500ms 聚合刷新，避免每帧触发。

8. 总结

• Qt Widgets 的本质是QWidget 双角色（控件/窗口）+ 对象树所有权 + 布局几何引擎；
• 布局是否"听话"取决于三个杠杆：sizeHint（控件意愿）、sizePolicy（伸缩策略）、stretch（额外空间分配），三者必须配合理解；
• 表单密集型桌面应用仍以 Widgets 为主力；动效/现代风格场景选 QML，两者可混合；
• QSS 是控件外观的声明式层，但注意它是样式引擎子集、动态属性需 polish 刷新；
• UI 线程规则（事件循环内操作控件、耗时任务移线程）与 Qt 事件循环/多线程篇的约定完全一致，跨线程碰控件是崩溃重灾区。

一句话心法：先想清楚"每个控件在窗口拉伸时应该怎样变化"，再选择 sizePolicy + stretch 组合；不要靠手写 resize 去对抗布局引擎。

9. FAQ 速查（10 条）

1. Q：布局里控件不跟随窗口放大？A：控件默认 Preferred 不抢额外空间；给目标控件 setSizePolicy(Expanding, ...) 或 addWidget(w, stretch)。
2. Q：setFixedSize 与 sizePolicy 哪个优先？A：Fixed 的 min==max 锁死，布局无法改变；想恢复需解除最小/最大限制。
3. Q：QTableWidget 如何让最后一列填满？A：horizontalHeader()->setStretchLastSection(true) 或 SectionResizeMode::Stretch。
4. Q：QSS 全局样式为何某些控件无效？A：可能是后代选择器写错、控件设置了内联 palette/字体、或需要 unpolish/polish 刷新动态属性。
5. Q：子线程能更新控件吗？A：不能直接操作；用信号槽（QueuedConnection）或 invokeMethod 回主线程。
6. Q：QRadioButton 如何跨 GroupBox 互斥？A：放入同一个 QButtonGroup（setExclusive(true)）。
7. Q：窗口内容超出屏幕？A：顶层窗口设置 setMinimumSize 合理值，布局内控件设 minimumSizeHint；或使用 QScrollArea 包裹内容。
8. Q：addStretch 与 QSpacerItem 区别？A：addStretch(1) 等价于一个水平/垂直 Expanding 的 QSpacerItem，是弹簧；QSpacerItem 可自定义两个方向的策略。
9. Q：如何让对话框自动适应内容？A：布局安装后 adjustSize()，或 layout->setSizeConstraint(QLayout::SetFixedSize)。
10. Q：Qt5 高 DPI 模糊怎么办？A：Qt5 需启用高 DPI 缩放（AA_EnableHighDpiScaling）并合理设置 rounding policy；自绘代码按 devicePixelRatio 缩放 painter。