直接用Toplevel无法实现真正模态行为，因其默认非模态；需组合grab_set()锁定焦点、wait_window()阻塞执行，并在destroy()前将结果存入实例属性。
为什么直接用 Toplevel 无法实现真正的模态行为
因为 Toplevel 默认是非模态的：用户仍可点击主窗口、触发其他逻辑，甚至重复打开多个弹窗。Tkinter 没有内置“阻塞式模态弹窗”API，必须手动组合 grab_set()、wait_window() 和事件循环控制才能模拟出“等待用户操作后才继续”的效果。
常见错误是只调用 grab_set() 却忘了 wait_window()，结果主窗口虽不能获取焦点，但后续代码立刻执行，根本没等用户点按钮。
-
grab_set()锁定输入焦点（仅限当前弹窗能响应事件） -
wait_window()阻塞当前函数执行，直到该弹窗被销毁 - 必须在弹窗关闭前设置好返回值存储位置（如实例变量），否则
wait_window()返回后无法读取
如何用类封装带返回值的模态弹窗
最可靠的方式是把弹窗写成一个继承自 Toplevel 的类，在关闭时把结果存到 self.result，再靠 wait_window() 等待销毁。主调用处直接读取该属性即可。
示例关键结构：
立即学习“Python免费学习笔记（深入）”；
class InputDialog(Toplevel):
def __init__(self, parent):
super().__init__(parent)
self.transient(parent) # 绑定到父窗口生命周期
self.grab_set() # 抢占输入焦点
self.result = None # 初始化返回值容器
<pre class="brush:php;toolbar:false;"> self.entry = Entry(self)
self.entry.pack()
Button(self, text="OK", command=self._on_ok).pack()
def _on_ok(self):
self.result = self.entry.get()
self.destroy() # 触发 wait_window 返回调用方式：
dialog = InputDialog(root) root.wait_window(dialog) # 阻塞直到 dialog.destroy() print(dialog.result) # 此时 result 已赋值
-
transient(parent)让弹窗始终显示在父窗口上方，且随父窗口最小化而隐藏 - 不要在
_on_ok中调用self.quit()或self.parent.quit()，会退出整个应用 - 如果弹窗可能被用户点右上角 × 关闭，需绑定
protocol("WM_DELETE_WINDOW", ...)并设默认result
为什么 wait_variable 或 wait_visibility 不适合返回值场景
这两个方法常被误用于“等待弹窗”，但它们不保证弹窗已关闭，也不提供自然的返回值传递路径。比如 wait_variable 需要额外维护一个 StringVar，且容易因变量作用域或未及时 set 导致死锁；wait_visibility 只等窗口可见，和“用户操作完成”完全无关。
-
wait_window()是唯一与窗口生命周期强绑定的阻塞原语 - 所有返回值必须在
destroy()前写入实例属性，不能依赖局部变量或闭包 - 若弹窗内含异步操作（如网络请求），需确保回调中仍能安全修改
self.result并调用destroy()
多按钮弹窗（如 Yes/No/Cancel）的返回值设计
按钮多，返回值类型就不再是字符串，而是枚举或标识符。建议用整数或字符串字面量（如 "yes"、"no"、"cancel"），避免布尔值——因为用户点 × 关闭时需要一个明确的默认分支。
典型写法：
def _on_yes(self):
self.result = "yes"
self.destroy()
def _on_no(self):
self.result = "no"
self.destroy()
def _on_cancel(self):
self.result = "cancel"
self.destroy()
# 并在 __init__ 中绑定 protocol：
self.protocol("WM_DELETE_WINDOW", lambda: setattr(self, "result", "cancel") or self.destroy())
- 用
setattr在一行里完成赋值+销毁，避免定义多余函数 - 避免用
True/False作返回值，否则无法区分 “用户点了 No” 和 “用户点了 ×” - 如果业务逻辑依赖返回值做分支，务必检查
dialog.result is not None，防止未初始化访问
真正卡住人的地方不是怎么画按钮，而是忘记 wait_window() 必须在弹窗实例上调用，且该实例不能被垃圾回收——一旦变量被覆盖或作用域结束，wait_window() 就失去目标，程序直接卡死或跳过等待。
