tkinter标准库无ttk.Tooltip类，需手写实现：监听Enter/Leave事件，用Toplevel+Label创建无边框浮窗，注意坐标计算、延迟显示及ttk控件事件绑定适配。
tkinter中ttk.Tooltip不存在，别白找文档了
Python标准库的tkinter（包括ttk）压根没提供Tooltip类。你搜到的很多教程要么是第三方包，要么是自己手写的简易实现——这点必须先确认清楚，否则会卡在“为什么导入报错”上浪费半小时。
官方只提供了底层能力：Enter和Leave事件、Label控件、winfo_pointerx()/winfo_pointery()坐标获取，剩下的得自己串起来。
- 别尝试
from tkinter.ttk import Tooltip，会触发ImportError -
tkinter.messagebox或simpledialog不是浮窗提示，它们是模态弹窗，会阻塞操作 - 第三方如
idlelib.tooltip虽可用，但属于IDLE内部模块，不保证跨Python版本稳定
用Toplevel + Label手写一个轻量Tooltip
核心思路：监听Enter事件创建一个无边框、半透明、带偏移的Toplevel窗口，里面放Label；监听Leave事件销毁它。关键在坐标计算和生命周期管理。
下面这段代码可直接复用，已处理常见坑：
import tkinter as tk
from tkinter import ttk
<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)</leave></enter></p><pre class="brush:php;toolbar:false;">def enter(self, event=None):
self.schedule()
def leave(self, event=None):
self.unschedule()
self.hidetip()
def schedule(self):
self.unschedule()
self.id = self.widget.after(500, self.showtip) # 延迟500ms显示，防误触
def unschedule(self):
id = self.id
self.id = None
if id:
self.widget.after_cancel(id)
def showtip(self):
if self.tipwindow or not self.text:
return
x, y, cx, cy = self.widget.bbox("insert") # 获取widget相对坐标
x += self.widget.winfo_rootx() + 25
y += self.widget.winfo_rooty() + 20
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=tk.LEFT,
background="#ffffe0", relief=tk.SOLID, borderwidth=1,
font=("TkDefaultFont", 8))
label.pack(ipadx=1)
def hidetip(self):
tw = self.tipwindow
self.tipwindow = None
if tw:
tw.destroy()使用示例：
root = tk.Tk() btn = ttk.Button(root, text="Hover me") btn.pack(pady=20) Tooltip(btn, "这是一个自定义浮窗提示！支持换行\n第二行内容。") root.mainloop()
-
after(500, ...)延迟显示，避免鼠标快速划过时弹窗闪现 -
bbox("insert")在部分控件（如Entry）可能返回None，此时建议改用winfo_width()/winfo_height()估算中心点 -
background="#ffffe0"是经典米黄底色，比纯白更柔和；深色主题下建议改用#333配白字
绑定到ttk控件时要注意事件是否生效
ttk.Button、ttk.Checkbutton等默认不响应<enter></enter>事件，因为它们把鼠标事件委托给了内部的Frame或Label子部件。直接绑在控件上会失效。
- 解决方案：用
bind_class绑定到整个控件类，例如btn.bind_class("TButton", "<enter>", ...)</enter> - 更稳妥做法：对
ttk控件，改用bind(">", ...)？不，ttk没有这个虚拟事件。老实用bind_class或改用tk.Button - 验证是否生效：临时加一句
print("enter!")在enter方法里，鼠标悬停看控制台输出
浮窗位置偏移不准？检查winfo_rootx()的调用时机
如果浮窗总出现在屏幕左上角或偏移巨大，大概率是winfo_rootx()被调用时控件还没完成布局（比如在__init__里就绑定tooltip，但pack()/grid()还没执行）。
- 确保控件已调用
pack()、grid()或place()后再初始化Tooltip - 调试技巧：打印
widget.winfo_rootx(), widget.winfo_rooty()，看是否为0或负数；若为0，说明布局未就绪 - 极端情况（如动态生成控件），可改用
widget.after(1, lambda: self.showtip())延迟执行坐标计算
真正难的不是写几行代码，而是让浮窗在各种缩放、多屏、DPI缩放环境下都稳稳贴着控件右下角出现——这需要反复测不同系统，别指望一次写完就完美。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
