应继承 tkinter.simpledialog.Dialog 而非 Toplevel，因其已内置模态控制、焦点管理与返回值封装；若必须用 Toplevel，则须补全 transient、grab_set 和关闭协议三步。
能自定义，但别直接继承 Toplevel 做“对话框”——它不阻塞、不模态、不自动处理焦点和关闭逻辑，容易变成半残窗口。
为什么 Toplevel 不是对话框的起点
很多人一想“我要个新窗口”，就立刻 class MyDialog(Toplevel)，结果发现：mainloop() 没法用、wait_window() 不生效、点主窗还能操作、按 Alt+Tab 会切走、关掉父窗子窗还挂着……根本不像用户认知里的“弹窗”。Toplevel 是通用浮动窗口基类，不是对话框封装。
真正该继承的是 tkinter.simpledialog.Dialog（轻量）或自己补全模态行为，而不是裸用 Toplevel。
- 必须手动调用
self.grab_set()锁定输入焦点 - 必须监听
WM_DELETE_WINDOW并调用self.destroy()+self.quit()，否则wait_window()卡死 - 必须在
__init__末尾加self.wait_visibility()和self.focus_set()，否则键盘焦点不进窗 - 如果父窗是
Tk()实例，要传parent给Toplevel构造，否则模态关系断裂
simpledialog.Dialog 是更安全的起点
它已经内置了模态控制、标准按钮绑定、返回值封装，你只管填内容和重写 body()、buttonbox()、apply()。适合表单类对话框（如输入名字、选选项）。
立即学习“Python免费学习笔记（深入）”；
示例关键片段：
class NameDialog(simpledialog.Dialog):
def body(self, master):
Label(master, text="姓名：").grid(row=0)
self.name_entry = Entry(master)
self.name_entry.grid(row=0, column=1)
return self.name_entry # 自动聚焦
<pre class='brush:python;toolbar:false;'>def apply(self):
self.result = self.name_entry.get()调用后会阻塞，直到窗口关闭
dialog = NameDialog(root, "请输入") print(dialog.result) # 用户点确定后的值
-
body()返回的 widget 决定初始焦点，不返回则需手动focus_set() -
apply()在点“确定”时触发；点“取消”则result为None - 不支持自定义按钮文字？得重写
buttonbox()，里面用Button手动构造 - 注意：Python 3.12+ 中
simpledialog的某些子类默认禁用 Esc 关闭，需显式绑定
真要继承 Toplevel，必须补这三件事
如果你需要完全自由布局（比如嵌入 Matplotlib 图、拖拽区域、非标准按钮），那可以继承 Toplevel，但以下三步缺一不可，否则就是“假对话框”：
- 初始化后立即调用
self.transient(parent)（声明父子关系） - 紧接着调用
self.grab_set()（捕获所有输入事件） - 绑定关闭协议：
self.protocol("WM_DELETE_WINDOW", lambda: self._on_close())，并在_on_close()里调用self.grab_release()+self.destroy()+self.parent.focus_set()
漏掉任何一条，都会导致：主窗可点击、Alt+Tab 可切出、关子窗后父窗失焦、再次打开报 invalid command name 错误。
返回值怎么拿？别用全局变量
常见错误是把输入结果存在全局变量或类属性里，然后靠轮询判断。正确做法是让调用方用 wait_window() 阻塞等待，并在关闭前把结果存进实例属性：
dialog = MyCustomDialog(root) root.wait_window(dialog) # 阻塞到这里 print(dialog.user_input) # 关闭后才执行
-
wait_window()必须在Tk实例上调用，不能在Toplevel上调 - 确保
dialog实例生命周期覆盖整个等待过程——别让它被垃圾回收（例如没赋给变量） - 如果对话框里有耗时操作（如网络请求），必须用
after()或线程+队列，不能直接在apply()里阻塞，否则整个 GUI 冻结
最易被忽略的是：模态窗口的关闭流程必须闭环——grab 要 release，destroy 要触发，parent 要重新 focus。少一步，后续交互就出鬼。
