QLabel不支持图文混排，因setText()与setPixmap()互斥；推荐用QHBoxLayout组合两个QLabel实现，兼顾稳定与适配性。
QLabel 本身不支持同时显示图片和文字——它只能二选一：要么用 setText() 显示文本，要么用 setPixmap() 显示图片。想实现“图文混排”，得绕开默认行为。
为什么直接 setText() + setPixmap() 不生效
调用 setPixmap() 会自动清空当前文本内容；反之，调用 setText() 也会丢弃已设置的 pixmap。这是 QLabel 的内部逻辑决定的：它把 text 和 pixmap 视为互斥内容源。
- 现象：先设图片再设文字，界面上只显示文字，图片消失
- 原因：
setText()内部会调用clearPixmap()，同理setPixmap()会清空文本 - 验证方式：打印
ui->label->text().isEmpty()和ui->label->pixmap() == nullptr可确认状态已被覆盖
三种可行方案：按场景选一种
没有银弹，只有适配需求的解法：
-
方案1（最轻量）：用富文本拼接图标字体 + 文字
适合图标少、风格统一的场景。例如用 Font Awesome 字体，把图标当字符嵌入 HTML：ui->label->setTextFormat(Qt::RichText); ui->label->setText("<span style="font-family:FontAwesome"></span> 首页"); -
方案2（推荐通用）：QHBoxLayout 布局 + QLabel 组合
新建两个 QLabel，一个放setPixmap()，一个放setText()，用布局管理器水平排列：QHBoxLayout *layout = new QHBoxLayout(ui->widget); layout->addWidget(labelIcon); layout->addWidget(labelText); layout->setSpacing(4); -
方案3（需定制）：继承 QLabel 重写 paintEvent()
适用于需要精确控制图文位置/缩放/对齐的高级场景。在自定义类中同时 drawPixmap() 和 drawText()，但要注意手动处理高分屏、缩放、DPR 等细节
注意 scaledContents 和 resizeEvent 的副作用
如果用了 setScaledContents(true)，再套进布局里，容易出现图片拉伸变形或布局尺寸错乱：
-
scaledContents是基于 QLabel 自身大小做等比缩放，一旦被布局约束尺寸（比如设了setMaximumWidth()），缩放结果就不可控 - 重写
resizeEvent()时若直接调用setPixmap()，可能触发重复缩放导致模糊——应缓存原始QPixmap，每次重绘时用QPainter::drawPixmap()手动缩放 - 高分屏下务必检查
devicePixelRatio()，否则QPixmap加载资源后可能模糊（尤其从:/*.png加载时）
真正难的不是“怎么拼”，而是“怎么拼得不掉帧、不糊、不随窗口乱跳”。多数情况下，方案2（布局组合）最稳——它把复杂度交给 Qt 布局系统，而不是自己在 paintEvent 里硬扛 DPI、缩放、重绘节奏这些事。
