Tkinter原生不支持tooltip，因其控件无hover事件或tooltip_text属性，需手动监听Enter/Leave事件并用Toplevel模拟实现；最简tooltip类包含延迟显示、定位更新与销毁三步逻辑。
为什么Tkinter原生不支持tooltip？
Tkinter本身没有内置的tooltip组件，官方控件如Button、Label等不提供hover事件或tooltip_text属性。你看到的“悬停提示”都是靠监听Enter和Leave事件，再手动创建一个临时Toplevel窗口模拟实现的——不是CSS那种声明式行为，得自己管显示、定位、销毁。
最简可用的tooltip类怎么写？
核心逻辑就三件事：鼠标进入时创建并显示提示窗，移动时更新位置，离开时销毁。下面这个轻量级实现已验证在Python 3.7+和主流Tk版本下稳定工作：
import tkinter as tk
<p>class ToolTip:
def <strong>init</strong>(self, widget, text):
self.widget = widget
self.text = text
self.tipwindow = None
self.id = None
self.x = self.y = 0
widget.bind("<Enter>", self.enter)
widget.bind("<Leave>", self.leave)
widget.bind("<ButtonPress>", self.leave)</p><pre class="brush:php;toolbar:false;">def enter(self, event=None):
self.schedule()
def leave(self, event=None):
self.unschedule()
self.hide()
def schedule(self):
self.unschedule()
self.id = self.widget.after(500, self.show) # 延迟500ms防误触
def unschedule(self):
id = self.id
self.id = None
if id:
self.widget.after_cancel(id)
def show(self):
if self.tipwindow or not self.text:
return
x, y, _, _ = self.widget.bbox("insert") # 获取控件坐标
x += self.widget.winfo_rootx() + 25
y += self.widget.winfo_rooty() + 25
self.tipwindow = tw = tk.Toplevel(self.widget)
tw.wm_overrideredirect(True) # 无边框
tw.wm_geometry(f"+{x}+{y}")
label = tk.Label(tw, text=self.text, justify="left",
background="#ffffe0", relief="solid", borderwidth=1,
font=("TkDefaultFont", 8))
label.pack(ipadx=1)
def hide(self):
tw = self.tipwindow
self.tipwindow = None
if tw:
tw.destroy()
用法很简单：ToolTip(button, "保存当前配置")。注意几点：
立即学习“Python免费学习笔记（深入）”；
-
after(500)是防抖关键，避免鼠标扫过一堆按钮时疯狂弹窗 -
bbox("insert")在某些控件（如Frame）上可能返回None，此时应改用winfo_rootx/y+winfo_width/height估算位置 -
Toplevel必须设wm_overrideredirect(True)，否则会带标题栏且遮挡主窗口焦点
按钮禁用时还要显示tooltip怎么办？
当button.config(state="disabled")后，<enter></enter>事件默认不触发。解决办法是让控件始终接收事件，仅视觉禁用：
- 不要用
state="disabled"，改用state="normal"+configure(cursor="arrow")+ 手动拦截<button-1></button-1> - 或者给禁用态按钮单独绑定事件：
button.bind("<enter>", lambda e: tooltip.show() if button['state'] == 'disabled' else None)</enter>，但需同步管理show/hide生命周期 - 更稳妥的做法：封装一个
HoverButton子类，在__init__里统一处理状态切换与tooltip联动
多语言或动态内容tooltip要注意什么？
如果提示文本要随语言切换或实时变化（比如显示当前数值），别把self.text写死在初始化里：
- 把
text参数改为可调用对象：lambda: f"剩余{count.get()}次" - 在
show()方法里调用它生成实际字符串，而不是存引用 - 若涉及中文，确保
Label字体支持UTF-8（TkDefaultFont通常没问题，但自定义字体要显式指定font=("SimSun", 9)之类） - 长文本需手动换行：
text.replace(" ", "\n")或用Text控件替代Label，但会增加复杂度
真正麻烦的是跨屏幕缩放——高DPI下winfo_rootx()返回值可能偏移，Windows上建议加root.tk.call('tk', 'scaling', 1.25)校准，macOS则通常无需干预。
