如何设置QTabWidget的tooltip仅在鼠标悬停标签标题时触发而非整个控件

你遇到的问题核心原因是QTabWidget的tooltip默认作用于整个控件范围，包括标签页内部空白、无自定义tooltip的子控件区域，只要Tooltip事件没有被子控件消费，就会触发父控件QTabWidget的全局tooltip。以下是两种可直接落地的简便方案：

方案1：最简实现（给标签栏单独设置Tooltip） #

无需复杂逻辑，直接将原来给QTabWidget设置的tooltip转移到其内部的标签栏控件即可，标签栏仅包含标签标题区域，Tooltip只会在该区域触发：

1. 清空Qt Designer中QTabWidget控件的原有tooltip内容
2. 在UI初始化代码中添加如下行即可：

# 假设你的QTabWidget对象名为tabWidget，替换成你自己的对象名
self.tabWidget.tabBar().setToolTip("你需要显示的全局标签tooltip内容")

如果需要给每个标签设置不同的tooltip，可调用setTabToolTip方法：

# 给索引为0的第一个标签设置单独tooltip
self.tabWidget.tabBar().setTabToolTip(0, "第一个标签的专属tooltip")

方案2：事件过滤器方案（保留原QTabWidget的Tooltip配置） #

如果不想修改原有QTabWidget的tooltip配置，可通过事件过滤器拦截Tooltip事件，仅当鼠标落在标签区域时才允许触发：

1. 保留Qt Designer中QTabWidget的tooltip配置
2. 在窗口类中添加事件过滤器逻辑，示例代码如下：

from PySide2.QtCore import QEvent
from PySide2.QtWidgets import QMainWindow

class YourMainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # 此处为你加载UI的原有逻辑
        # self.setupUi(self) 或者 uic.loadUi("xxx.ui", self)
        
        # 给QTabWidget安装事件过滤器
        self.tabWidget.installEventFilter(self)
    
    def eventFilter(self, watched, event):
        if watched == self.tabWidget and event.type() == QEvent.ToolTip:
            # 将鼠标坐标从QTabWidget坐标系转换为标签栏坐标系
            pos_in_tabbar = self.tabWidget.tabBar().mapFromParent(event.pos())
            # 判断坐标是否落在某个标签上
            tab_index = self.tabWidget.tabBar().tabAt(pos_in_tabbar)
            if tab_index < 0:
                # 不在标签区域，忽略事件阻止tooltip弹出
                event.ignore()
                return True
        # 其余事件走默认处理逻辑
        return super().eventFilter(watched, event)

两种方案均适配PySide2 Qt5.x版本，不需要修改Qt Designer生成的UI文件，重新编译UI代码也不会失效。

内容的提问来源于stack exchange，提问作者rbaleksandar