自定义CustomTkinter Yes/No提示框触发_tkinter.TclError异常求助

问题概述 #

基于CustomTkinter实现自定义Yes/No提示框，需求如下：

• 支持设置默认选项
• 倒计时结束后自动销毁窗口并采用默认值

实现后出现偶发不可预测异常：功能有时正常，但点击按钮时偶尔触发_tkinter.TclError，报错信息包含：

• can't delete Tcl command
• invalid command name ".!ctkframe2.!ctkcanvas"

怀疑异常与倒计时定时器的异步执行有关，运行环境为Windows 11、Python 3.11虚拟环境，已安装最新版CustomTkinter。

初始代码 #

import customtkinter as ctk
import tkinter as tk
from tkinter import messagebox

class CustomYesNoDialog(ctk.CTkToplevel):
    def __init__(self, parent, title, message, default="no", countdown=5):
        super().__init__(parent)
        self.title(title)
        self.result = None
        self.default = default
        self.countdown = countdown

        self.label = ctk.CTkLabel(self, text=f"{message}\n将在{countdown}秒后自动选择{default}")
        self.label.pack(padx=20, pady=20)

        self.button_frame = ctk.CTkFrame(self)
        self.button_frame.pack(padx=20, pady=(0,20), fill="x")

        self.yes_btn = ctk.CTkButton(self.button_frame, text="Yes", command=self.on_yes)
        self.yes_btn.pack(side="left", padx=5, pady=5)

        self.no_btn = ctk.CTkButton(self.button_frame, text="No", command=self.on_no)
        self.no_btn.pack(side="right", padx=5, pady=5)

        self.update_countdown()

    def update_countdown(self):
        if self.countdown > 0:
            self.countdown -= 1
            self.label.configure(text=f"{self.label.cget('text').split('\n')[0]}\n将在{self.countdown}秒后自动选择{self.default}")
            self.after(1000, self.update_countdown)
        else:
            self.on_default()

    def on_yes(self):
        self.result = "yes"
        self.destroy()

    def on_no(self):
        self.result = "no"
        self.destroy()

    def on_default(self):
        self.result = self.default
        self.destroy()

# 使用示例
if __name__ == "__main__":
    ctk.set_appearance_mode("dark")
    ctk.set_default_color_theme("blue")
    root = ctk.CTk()
    root.withdraw()
    dialog = CustomYesNoDialog(root, "确认", "是否执行此操作？", default="yes", countdown=5)
    dialog.grab_set()
    root.wait_window(dialog)
    print("结果:", dialog.result)
    root.mainloop()

错误日志 #

_tkinter.TclError: can't delete Tcl command
_tkinter.TclError: invalid command name ".!ctkframe2.!ctkcanvas"

问题根源 #

1. 定时器与手动操作冲突：用户点击按钮手动销毁窗口后，倒计时定时器仍在后台运行，尝试更新已销毁的组件（如标签）或触发默认操作，导致访问不存在的Tcl命令。
2. 组件销毁顺序问题：窗口销毁时，CustomTkinter的内部组件（如Canvas）已被释放，但回调函数仍试图引用这些组件。

修复方案 #

1. 添加定时器取消逻辑：在窗口销毁或按钮点击时，取消未执行的after定时器。
2. 标记窗口状态：在销毁前标记窗口为已关闭，避免后续操作访问无效组件。
3. 所有回调执行前先检查组件状态。

修复后的最终代码 #

import customtkinter as ctk
import tkinter as tk

class CustomYesNoDialog(ctk.CTkToplevel):
    def __init__(self, parent, title, message, default="no", countdown=5):
        super().__init__(parent)
        self.title(title)
        self.result = None
        self.default = default
        self.countdown = countdown
        self._is_closed = False  # 标记窗口是否已关闭
        self._after_id = None  # 存储定时器ID

        self.label = ctk.CTkLabel(self, text=f"{message}\n将在{countdown}秒后自动选择{default}")
        self.label.pack(padx=20, pady=20)

        self.button_frame = ctk.CTkFrame(self)
        self.button_frame.pack(padx=20, pady=(0,20), fill="x")

        self.yes_btn = ctk.CTkButton(self.button_frame, text="Yes", command=self.on_yes)
        self.yes_btn.pack(side="left", padx=5, pady=5)

        self.no_btn = ctk.CTkButton(self.button_frame, text="No", command=self.on_no)
        self.no_btn.pack(side="right", padx=5, pady=5)

        self.update_countdown()

        # 窗口关闭时触发清理
        self.protocol("WM_DELETE_WINDOW", self.on_destroy)

    def update_countdown(self):
        if self._is_closed:
            return
        if self.countdown > 0:
            self.countdown -= 1
            base_text = self.label.cget('text').split('\n')[0]
            self.label.configure(text=f"{base_text}\n将在{self.countdown}秒后自动选择{self.default}")
            self._after_id = self.after(1000, self.update_countdown)
        else:
            self.on_default()

    def cancel_timer(self):
        # 取消未执行的定时器
        if self._after_id is not None:
            self.after_cancel(self._after_id)
            self._after_id = None

    def on_yes(self):
        if self._is_closed:
            return
        self.cancel_timer()
        self.result = "yes"
        self.on_destroy()

    def on_no(self):
        if self._is_closed:
            return
        self.cancel_timer()
        self.result = "no"
        self.on_destroy()

    def on_default(self):
        if self._is_closed:
            return
        self.cancel_timer()
        self.result = self.default
        self.on_destroy()

    def on_destroy(self):
        if self._is_closed:
            return
        self._is_closed = True
        self.cancel_timer()
        self.destroy()

# 使用示例
if __name__ == "__main__":
    ctk.set_appearance_mode("dark")
    ctk.set_default_color_theme("blue")
    root = ctk.CTk()
    root.withdraw()
    dialog = CustomYesNoDialog(root, "确认", "是否执行此操作？", default="yes", countdown=5)
    dialog.grab_set()
    root.wait_window(dialog)
    print("结果:", dialog.result)
    root.mainloop()

修复说明 #

• 添加_is_closed状态标记，所有组件操作前先检查窗口是否已关闭，避免访问无效组件。
• 用_after_id存储定时器ID，在按钮点击、默认触发或窗口关闭时调用cancel_timer()取消未执行的定时器。
• 统一窗口销毁逻辑到on_destroy()方法，确保所有清理操作（取消定时器、标记状态）都被执行。

内容的提问来源于stack exchange，提问作者N. Maks