1. 背景1.1 为什么需要Qt WidgetsQt 提供了三套 UI 技术栈Qt Widgets命令式、面向对象、控件驱动、Qt Quick/QML声明式、GPU 场景图、以及底层绘制 APIQPainter、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维度Qt WidgetsQt Quick/QML编程范式命令式 C声明式 QML JS渲染CPU 光栅化Raster/OpenGL 可选的 QOpenGLWidgetGPU 场景图Scene Graph控件丰富度原生控件非常全表格/树/选项卡/对话框基础控件 自绘 Item动画/过渡较弱QPropertyAnimation 可用极强性能大量 Item中控件对象重高轻量 Item学习曲线类层次明确、C 直觉QML 语法 属性绑定心智适合表单/表格/对话框密集型工具软件现代风格、动效丰富、移动端真实工程常用混合策略主体 Widgets 局部 QMLQQuickWidget 嵌入取两者之长。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与所有权子控件必须指定 parentnew QLabel(parent)或事后 setParent()父对象负责销毁子对象parent 析构时递归删除所有子控件Qt 对象树机制布局管理器会把控件reparent到布局所属的容器上layout-addWidget(w) 等价于把 w 的 parent 设为容器因此不需要同时手动 setParent 与 addWidget千万不能 new 一个控件又不给 parent 又忘记 delete——要么给 parent要么自己管理内存。2.3 几何模型pos / size / geometry / frameGeometryAPI含义pos() / move(x,y)控件左上角在父坐标系中的位置不含边框/标题栏size() / resize(w,h)控件自身内容区尺寸geometry() / setGeometry(x,y,w,h)位置 尺寸相对于父不含 frameframeGeometry()含边框的矩形顶层窗口含标题栏x() / y() / width() / height()常用便捷函数contentsRect()内容区扣除 frame 后真正可绘制区域⚠️ 手写 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 布局最核心也最被误解的概念。每个控件有水平/垂直两个方向的策略取值策略含义Fixed固定为 sizeHint不伸缩Minimum不小于 sizeHint可伸缩变大Maximum不大于 sizeHint可收缩变小Preferred首选 sizeHint可伸缩Expanding首选 sizeHint且会尽量占用额外空间MinimumExpanding不小于 sizeHint且尽量占用额外空间Ignored忽略 sizeHint完全交给布局判断规则直觉版默认控件策略多为 Preferred——不会主动抢占额外空间想让控件随窗口拉伸而变大必须 Expanding/MinimumExpanding或设置 stretch 因子想让控件锁死尺寸用 Fixed 或 setFixedSize二者等价效果但 setFixedSize 会同时锁定 min/max。3. API 说明与速查3.1 QWidget 通用 API高频// 尺寸与几何 w-setFixedSize(200, 40); // 锁定尺寸minmax指定值 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 列 stretch1 grid-setRowStretch(2, 2); // 第 2 行 stretch2 grid-setColumnMinimumWidth(0, 80); grid-setRowMinimumHeight(0, 30);QFormLayoutauto *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 速查控件常用 APIQPushButtonsetText/setIcon/setCheckable/setChecked/click()/toggled(bool)QLineEditsetText/text()/setPlaceholderText/setEchoMode(QLineEdit::Password)/setValidator/returnPressed/textChanged(QString)QTextEdit/QPlainTextEditsetPlainText/toPlainText/append/insertPlainTextQComboBoxaddItem(text, userData)/addItems/currentText/currentData/setEditable/setCurrentIndexQCheckBoxsetChecked/isChecked/toggled/stateChangedQRadioButtonsetChecked/isChecked配 QButtonGroup 互斥QSpinBox/QDoubleSpinBoxsetRange/setValue/value/setSingleStep/setPrefix/setSuffixQSlidersetRange/setValue/value/valueChanged/setOrientationQProgressBarsetRange/setValue/value/setFormat(%p%)QListWidgetaddItem/currentItem/currentRow/setCurrentRow/itemDoubleClickedQTableWidgetsetRowCount/setColumnCount/setItem(row,col,item)/item(row,col)/setHorizontalHeaderLabelsQTreeWidgetsetHeaderLabels/addTopLevelItem/currentItem/expandAllQTabWidgetaddTab(w, title)/setCurrentIndex/currentIndex/currentWidgetQGroupBoxsetTitle/setCheckable/setChecked可勾选分组QScrollAreasetWidget(w)/setWidgetResizable(true)QStackedWidgetaddWidget/setCurrentIndex/currentIndexQSplitteraddWidget/setSizes({...})/setStretchFactor/index3.4 窗口体系QMainWindow / QDialogQMainWindow主窗口骨架有中央区 菜单栏 工具栏 状态栏 停靠区QDockWidget中央区必须 setCentralWidgetQDialog对话框基类exec() 模态运行返回 QDialog::Accepted/Rejectedaccept()/reject()/done(int) 结束setModal(true) 或 exec() 自带模态顶层 QWidget 也可当窗口用但没有菜单栏/状态栏便利设施。3.5 QSSQt 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[checkabletrue]、后代 QWidget QLineEdit、子对象 QGroupBox QLineEdit、伪状态 :hover/:pressed/:checked/:disabled/:focus、动态属性 [stateok]需 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); // stretch1edit 抢占水平额外空间 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); // stretch1垂直抢额外空间 // 底部固定按钮行 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 的实现核心是 QWidgetPrivatePIMPL 模式。QWidget::show() 最终调用 QWidgetPrivate::setVisible → 创建原生窗口QPlatformWindowQt 通过QPAQt Platform Abstraction插件层把控件映射到 Windows/WinAPI、X11、Wayland、macOS 等平台。控件自身的内存布局child list、geometry、flags与原生句柄分离HWND 等原生窗口只在需要时创建部分控件可合并到父窗口减少句柄数称为 native vs alien widgets——Windows 上默认 alien大幅减少资源占用。5.2 布局引擎的几何传播算法布局系统工作流程resize 触发容器 resizeEvent → 容器 Layout 的 setGeometry布局管理器读取每个子项的 sizeHint / minimumSizeHint / maximumSize / sizePolicy计算需求每项最小尺寸 max(minimumSizeHint, sizePolicy 强制的 min)首选尺寸 sizeHintstretch 因子分配额外空间 容器内容区尺寸 - 各项最小需求之和 - 间距边距额外空间按 stretch 加权分配给 Expanding/MinimumExpanding 或 stretch0 的项若空间不足优先收缩 Shrinkable 项策略非 Fixed/Minimum 的项仍不够则触发最小尺寸限制递归处理嵌套布局直到叶子控件最终调用每个控件的 setGeometry。QLayout 本身是抽象真正干活的是 QBoxLayout 的 setGeometries/itemGeometry 等虚函数逐项按 QGridLayout 的 grid 二维结构计算行列宽高。5.3 sizePolicy 与 sizeHint 的组合公式布局对某个方向如水平的处理等价于min_i policy 允许的最小宽度Fixed→w_hintPreferred/Minimum→min_w... pref_i w_hint或 policy 修正后的首选 max_i policy 允许的最大宽度Fixed→w_hintExpanding→∞... 实际宽度: 若 total_pref available: w_i pref_i extra_iextra 按 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 条不给 parent 的 new控件泄漏或悬空务必 parent 或手动管理。同时 setParent 与 addWidgetaddWidget 会自动 reparent重复设置一般无害但易混淆不要在两处分别 delete。手写 resize/move 后又被布局覆盖布局接管几何后手写设置会被下一轮布局冲刷想固定用 sizePolicy/stretch/Fixed。忘了 setCentralWidgetQMainWindow 直接 addWidget 到布局不生效——必须 setCentralWidget(w) 再给 w 设布局。布局被重复安装setLayout 只能装一次嵌套布局用 addLayout不要在容器上再 setLayout。sizePolicy 理解错误Preferred 不会抢占空间想要随窗口放大必须 Expanding stretch。setFixedSize 与 sizePolicy 冲突Fixed 后 stretch 无效改大小时先解除 fixedsetMinimumSize/setMaximumSize 恢复。QTableWidget 列宽不随窗口默认列不自动拉伸用 horizontalHeader()-setSectionResizeMode(QHeaderView::Stretch) 或 Interactive。表格 item 悬空setItem(row,col,new QTableWidgetItem(...)) 传栈对象或未 new 的指针会崩必须 new表接管所有权。QComboBox 数据混乱addItem(text) 后 currentData() 是 QVariant()需要 userData 用 addItem(text, QVariant::fromValue(id))。QRadioButton 不互斥同一父下多个 radio 默认互斥但放到不同 GroupBox 后互相独立跨组互斥需 QButtonGroup。QSS 不生效常见原因——写错对象名、控件在子类中样式被内联覆盖、动态属性未 polish、样式表字符串引号/分号错误。QSS 影响性能大表格大量控件用复杂 QSS 会拖慢必要时只给关键控件设置样式对象名选择器更精准。中文乱码/字体缺失Windows 上设置 QApplication::setFont(QFont(Microsoft YaHei))源码用 UTF-8 QStringLiteral/u8 前缀MSVC 需 /utf-8。UI 线程卡死在槽里做耗时操作读文件/网络/协议栈导致界面无响应耗时任务移线程/异步结果通过信号回主线程。跨线程直接操作控件子线程 setText/show 是未定义行为崩溃或偶发用信号槽 QueuedConnection 或 QMetaObject::invokeMethod(..., Qt::QueuedConnection)。高 DPI 模糊Qt5 需 QApplication::setHighDpiScaleFactorRoundingPolicy 环境变量Qt6 默认支持但自定义 paintEvent 里要按 devicePixelRatio 处理。paintEvent 里做重活绘制中分配对象/加载图片会卡 UI预处理缓存到成员paintEvent 只做绘制。deleteLater 与布局移除顺序removeWidget 不 delete想销毁用 delete w 或 w-deleteLater()注意先从布局移除。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 工程化建议用 .ui 文件Qt Designer uic复杂界面先拖拽设计再代码微调避免手写布局错误控件统一 setObjectNameQSS 用对象名选择器避免全局类型样式互相污染界面代码与业务分离Widget 子类只负责展示数据经信号/模型注入皮肤化把 QSS 做成外部 .qss 文件运行时加载便于换肤与现场调试定时器驱动刷新节流传感器等高频数据更新 UI 时按 100ms~500ms 聚合刷新避免每帧触发。8. 总结Qt Widgets 的本质是QWidget 双角色控件/窗口 对象树所有权 布局几何引擎布局是否听话取决于三个杠杆sizeHint控件意愿、sizePolicy伸缩策略、stretch额外空间分配三者必须配合理解表单密集型桌面应用仍以 Widgets 为主力动效/现代风格场景选 QML两者可混合QSS 是控件外观的声明式层但注意它是样式引擎子集、动态属性需 polish 刷新UI 线程规则事件循环内操作控件、耗时任务移线程与 Qt 事件循环/多线程篇的约定完全一致跨线程碰控件是崩溃重灾区。一句话心法先想清楚每个控件在窗口拉伸时应该怎样变化再选择 sizePolicy stretch 组合不要靠手写 resize 去对抗布局引擎。9. FAQ 速查10 条Q布局里控件不跟随窗口放大A控件默认 Preferred 不抢额外空间给目标控件 setSizePolicy(Expanding, ...) 或 addWidget(w, stretch)。QsetFixedSize 与 sizePolicy 哪个优先AFixed 的 minmax 锁死布局无法改变想恢复需解除最小/最大限制。QQTableWidget 如何让最后一列填满AhorizontalHeader()-setStretchLastSection(true) 或 SectionResizeMode::Stretch。QQSS 全局样式为何某些控件无效A可能是后代选择器写错、控件设置了内联 palette/字体、或需要 unpolish/polish 刷新动态属性。Q子线程能更新控件吗A不能直接操作用信号槽QueuedConnection或 invokeMethod 回主线程。QQRadioButton 如何跨 GroupBox 互斥A放入同一个 QButtonGroupsetExclusive(true)。Q窗口内容超出屏幕A顶层窗口设置 setMinimumSize 合理值布局内控件设 minimumSizeHint或使用 QScrollArea 包裹内容。QaddStretch 与 QSpacerItem 区别AaddStretch(1) 等价于一个水平/垂直 Expanding 的 QSpacerItem是弹簧QSpacerItem 可自定义两个方向的策略。Q如何让对话框自动适应内容A布局安装后 adjustSize()或 layout-setSizeConstraint(QLayout::SetFixedSize)。QQt5 高 DPI 模糊怎么办AQt5 需启用高 DPI 缩放AA_EnableHighDpiScaling并合理设置 rounding policy自绘代码按 devicePixelRatio 缩放 painter。
