Qt界面卡顿主因是渲染路径误用与重绘失控：QWidget+QPainter需关WA_OpaquePaintEvent防强制全刷，QOpenGLWidget须统一设置抗锯齿格式，QML必用ListView虚拟化替代Repeater，QSS慎用伪状态防盒模型重排。
Qt界面卡顿，八成不是样式写错了，而是渲染路径选错了或重绘没节制。CPU软绘、GPU硬绘、QML场景图这三条路，混着用等于自设障碍；高频刷新不防抖、大批量控件不用虚拟化、离屏缓存不配双缓冲，性能瓶颈就藏在这些细节里。
QWidget + QPainter 重绘太慢？先关掉 WA_OpaquePaintEvent 再说
很多项目一加阴影、渐变就掉帧，第一反应是“QPainter太慢”，其实常是 WA_OpaquePaintEvent 没关导致整块区域被强制重绘。这个属性默认开启，意思是“我这个 widget 背景完全不透明，系统可以跳过背景擦除”。但一旦你用了半透明色、径向渐变或 QPainter::setOpacity()，它反而会触发额外的合成步骤，拖慢整个绘制链。
- 检查是否真需要该标志：如果 widget 背景有透明/半透明区域，或用了
QPainter::drawPixmap()带 alpha 的图，务必调用setAttribute(Qt::WA_OpaquePaintEvent, false) - 配合
update(QRect)精确重绘区域，避免全 widget 刷新；别依赖repaint()，它绕过事件队列，容易引发重入和撕裂 - 复杂自绘控件（如仪表盘）建议启用双缓冲：
setAutoFillBackground(false)+ 手动在QPixmap上绘制再drawPixmap()到 painter，比直接在 widget 上画快 2–3 倍
QOpenGLWidget 渲染卡顿？上下文切换和高分屏适配是主因
QOpenGLWidget 不是“开了就快”，它和 QWidget 共存时，Qt 默认用 QSurfaceFormat::setDefaultFormat() 配置 OpenGL 上下文，但 macOS / Windows 高分屏下若没显式设置 setSamples(4) 或 setAlphaBufferSize(8)，会导致每次绘制前都触发隐式 FBO 切换，帧时间飙升。
- 初始化时必须统一设置格式：
QSurfaceFormat fmt; fmt.setSamples(4); fmt.setAlphaBufferSize(8); QSurfaceFormat::setDefaultFormat(fmt); - 避免在
paintGL()里频繁调用glGenBuffers()或glTexImage2D()；纹理和 VBO 应提前创建并复用，实例化渲染（glVertexAttribDivisor()）比循环 draw calls 快一个数量级 - 主线程只做状态更新，GPU 渲染逻辑尽量封装进
QOpenGLFunctions子类；跨线程访问 OpenGL 资源必须用QOpenGLContext::moveToThread()+doneCurrent()/makeCurrent()配对
QML 大量 Item 卡死？别用 Repeater，ListView 是唯一解
1000 条数据用 Repeater，内存涨到 40MB、滚动掉帧是必然结果。QML 的 ListView 底层靠虚拟化（item reuse + cacheBuffer），而 Repeater 是静态展开——它不管你在不在视口，全量 new。
- 哪怕只是显示纯文本列表，也必须用
ListView；cacheBuffer: 200可预加载视口外 200px 的 item，滚动更顺 - delegate 里禁用
Binding和PropertyAnimation，改用Behavior on property+NumberAnimation，减少绑定引擎开销 - 模型更新走
ListModel.append()或clear()+set()，别直接操作 JS array 后赋值给 model，否则触发全量重建
QSS 样式越写越卡？盒模型和伪状态是隐形杀手
QSS 本身不绘图，但它驱动 QStyle 计算布局和绘制逻辑。一个 QPushButton:hover { background: qlineargradient(...) } 看似简单，实际每次鼠标移动都会触发 QStyle::drawControl() + 整个盒模型重排，尤其嵌套在 QScrollArea 里时，重绘频率爆炸。
- 慎用
:hover/:pressed触发复杂渐变或阴影；优先用QPalette设置静态色，或用QGraphicsEffect替代border-image - 避免在父容器上设
padding+ 子控件设margin叠加，Qt 的盒模型计算是递归的，嵌套深了 layout pass 时间翻倍 - QSS 文件超过 50 行建议拆分，用
qApp->setStyleSheet()动态加载时，旧样式不会自动 GC，残留的 selector 仍参与匹配计算
真正卡顿的根源，往往不在“怎么画”，而在“画多少次”和“让谁来画”。QPainter 的边界控制、QOpenGLWidget 的上下文生命周期、QML 的 item 复用策略、QSS 的匹配开销——这些环节一旦错位，优化再多单点技巧也白搭。最常被跳过的一步是：用 QElapsedTimer 实测每个 paintEvent 或 beforeRendering 的耗时，而不是凭感觉调参数。
