tkinter原生无ToolTip因Tk未提供标准组件，需手动实现：用Label+after+事件绑定，核心是延迟显示、及时隐藏、焦点管理，并注意控件兼容性与内存泄漏。
为什么 tkinter 原生没有 ToolTip
因为 tkinter 是对 Tcl/Tk 的轻量封装，而 Tk 本身不提供标准 tooltip 组件——它只靠 bind 手动控制显示/隐藏，得自己算位置、延迟、销毁逻辑。直接用 Label + after + event.x_root 是最常见做法，但容易漏掉焦点切换、窗口失焦、多控件重叠等边界情况。
怎么写一个靠谱的 ToolTip 类（非第三方）
核心是三个动作：鼠标进入时启动延迟计时器，悬停超时后显示；鼠标移出或点击其他地方时立即隐藏；窗口失去焦点时也要收起。别用 time.sleep，必须用 widget.after(ms, callback)。
-
__init__接收绑定控件、提示文本、delay=500（毫秒），内部建一个self.tipwindow = None -
showtip中先检查self.tipwindow是否已存在，避免重复创建 -
hidetip必须调用self.tipwindow.destroy()并置空，否则内存泄漏 - 绑定事件用
widget.bind("<Enter>", self.enter)和<Leave>，但别忘加<Button-1>和<FocusOut>
class ToolTip:
def __init__(self, widget, text, delay=500):
self.widget = widget
self.text = text
self.delay = delay
self.tipwindow = None
self.id = None
widget.bind("<Enter>", self.enter)
widget.bind("<Leave>", self.leave)
widget.bind("<Button-1>", self.leave)
widget.bind("<FocusOut>", self.leave)
<pre class='brush:python;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(self.delay, self.showtip)
def unschedule(self):
if self.id:
self.widget.after_cancel(self.id)
self.id = None
def showtip(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() + 20
self.tipwindow = tk.Toplevel(self.widget)
self.tipwindow.wm_overrideredirect(True)
self.tipwindow.wm_geometry(f"+{x}+{y}")
label = tk.Label(self.tipwindow, text=self.text, justify=tk.LEFT,
background="#ffffe0", relief=tk.SOLID, borderwidth=1)
label.pack()
ttk.Button 或 Entry 上用 ToolTip 的坑
不是所有控件都支持 bbox("insert") —— ttk.Button 没有 bbox 方法，Entry 在无焦点时可能返回 None。得 fallback 到控件整体坐标：
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 改用
widget.winfo_rootx() + widget.winfo_width() // 2算水平中心 -
y改用widget.winfo_rooty() - 20（让 tip 出现在控件上方，更自然） - 对
ttk控件，bind前先widget.update_idletasks()，确保尺寸已计算 - 如果提示文字含换行，
Label要加wraplength=200和justify=tk.LEFT
为什么 tooltip 常在鼠标移开后还残留
根本原因就两个：一是 hidetip 没清掉 after 计时器，导致 showtip 仍被执行；二是 tipwindow 销毁后没置空，下次 showtip 不走创建逻辑但又没内容可显，界面卡住。
立即学习“Python免费学习笔记（深入）”；
调试时打印 print("create", self.tipwindow) 和 print("destroy", self.tipwindow) 很快能定位。另外，Windows 下如果主窗口最小化，tooltip 可能卡在屏幕角落不消失——加一句 self.widget.winfo_exists() 判断再决定是否显示，能避开这个 bug。
