QTabWidget添加页面推荐用addTab(widget,"标题")，addWidget()需手动设标题；切换响应用currentChanged信号并传索引；隐藏标签页应先removeTab再insertTab保存widget指针；高DPI下图标模糊需用QIcon+@2x资源。
QTabWidget 添加页面时必须用 addWidget() 而不是 addTab()？
不是必须，但容易混淆：addTab() 是最常用的方式，它内部会自动创建一个新页面并添加；addWidget() 是底层接口，适用于你已经构造好 widget、想手动管理生命周期的场景。误用 addWidget() 而不设置标题，会导致标签页显示为空白（只有小方块），因为没调用 setTabText() 或传入标题参数。
推荐做法：
- 用
addTab(widget, "标题")快速添加带标题的页面 - 若 widget 需提前配置（比如设布局、连接信号），先 new 出来，再用
addTab(widget, "标题")，不要用addWidget(widget)后再补标题——容易漏 -
insertTab(index, widget, "标题")适合动态插入到指定位置，比如日志页总放在最后，但新模块要插在中间
切换标签页时如何响应并获取当前页索引？
currentChanged 信号是唯一可靠方式，别监听 tabBarClicked() ——它在用户点击已激活标签时也会触发，逻辑错乱。信号参数是 int 类型的索引值，从 0 开始。
常见错误写法：connect(tabWidget, &QTabWidget::currentChanged, this, &MyClass::onTabChanged) 没问题，但函数里直接用 tabWidget->currentWidget() 取到的是切换后的 widget，而索引值才是最稳定的标识（尤其 widget 可能为 nullptr）。
实操建议：
- 槽函数签名保持为
void onTabChanged(int index)，优先用index做分支判断 - 需要访问 widget 再调
widget(index)，避免currentWidget()返回空指针（比如 tab 被移除后还没刷新） - 如果要延迟执行（比如加载耗时内容），记得用
QMetaObject::invokeMethod(..., Qt::QueuedConnection)，防止重入
怎么隐藏某个标签页但不销毁它？
Qt 没有内置“隐藏单个 tab”的 API，removeTab() 会删 widget，setTabEnabled(false) 只禁用不可点，标签仍可见。真实需求往往是“临时收起”，正确做法是：把 widget 从 QTabWidget 中取下，存起来，再用 insertTab() 加回去。
关键点：
- 用
widget(index)获取指针后，立刻调removeTab(index)（注意：此时 index 会变化，所以先记下 widget 指针比记 index 更安全） - 保存 widget 指针到成员变量（如
QPointer），避免野指针m_hiddenPage - 恢复时用
insertTab(0, m_hiddenPage, "标题")，再调setCurrentIndex(0) - 别用
hide()或setVisible(false)对 tab bar 项操作——无效，QTabBar 不暴露单个 tab 的控制接口
QTabWidget 在高 DPI 缩放下图标模糊或文字错位？
根本原因是 tab 图标没做多分辨率适配，或者样式表用了固定像素值。QTabWidget 默认不缩放 pixmap，setIconSize() 也不能解决所有情况。
有效解法：
- 图标资源用
QIcon构造，而不是QPixmap；确保 .qrc 中包含 @2x 版本（如icon.svg或icon.png+icon@2x.png） - 避免在样式表里写死
height: 24px这类绝对值，改用min-height: 2em或留空让 Qt 自适应 - 如果用了自定义 tab bar（
setTabBar(new MyTabBar)），务必重写sizeHint()并乘以devicePixelRatioF() - Windows 上启用了“允许 Windows 覆盖高 DPI 缩放”选项时，需在
main()开头加QApplication::setAttribute(Qt::AA_EnableHighDpiScaling)
最常被忽略的是图标资源本身没提供多倍图——其他都调对了，还是糊，就卡在这一步。
