PyQt5 QLabel内嵌超链接title不生效，如何实现鼠标悬浮提示文本？

问题根因 #

Qt 内置的富文本渲染引擎仅支持有限的 HTML 标签与属性，<a> 标签的 title 属性不在其支持范围内，因此直接写在富文本中的 title 无法触发悬浮提示。

替代实现方案 #

方案1：绑定 linkHovered 信号（推荐，多链接场景通用） #

该方案无需修改原有富文本结构，仅需新增信号绑定逻辑即可，适配多超链接场景：

from PyQt5.QtGui import QCursor
from PyQt5.QtWidgets import QToolTip

# 原有初始化逻辑不变
label = QLabel("<b>Name</b>: ABC | <b>Contact</b>: <a style='text-decoration:none;color:black'href='mailto:abc@gmail.com' title='this is a link to email'>abc@gmail.com</a>")
label.setTextFormat(Qt.RichText)
label.setOpenExternalLinks(True)

# 新增超链接悬浮提示逻辑
link_tip_map = {
    "mailto:abc@gmail.com": "this is a link to email"
    # 可继续添加其他超链接与对应提示
}
label.linkHovered.connect(lambda href: QToolTip.showText(
    QCursor.pos(),
    link_tip_map.get(href, ""),
    label
))

方案2：直接设置 QLabel 全局提示（单链接场景适用） #

如果当前 QLabel 仅存在一个超链接，且其余区域不需要单独的提示逻辑，可以直接给 QLabel 整体设置提示，代码最简单：

label.setToolTip("this is a link to email")

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