使用Tkinter colorchooser后按钮图片消失且按钮失效问题排查

问题场景 #

开发Python GUI程序时，使用Tkinter的colorchooser组件实现颜色选择功能。将触发按钮设置为显示图片而非文本，但调用colorchooser.askcolor()后，按钮上的图片消失，且按钮变为禁用状态。换成文本按钮则无此异常。

问题代码 #

import tkinter as tk
from tkinter import colorchooser

class MainGUI(tk.Tk):
    def __init__(self):
        super().__init__()
        addImage = r'C:\Documents\Scripting\VisualStudio\ClispiPy\ClispiPy\Images\Add.png'
        addPhoto = tk.PhotoImage(file = addImage)
        tk.Button(self, image=addPhoto, command=self.open_sub_gui).pack(pady=20)

    def open_sub_gui(self):
        col = colorchooser.askcolor(title='Select Color')
        return

if __name__ == "__main__":
    main_gui = MainGUI()
    main_gui.mainloop()

界面对比 #

操作前界面：

操作后界面：

原因分析 #

问题核心是**PhotoImage对象被Python垃圾回收机制回收**。Tkinter的PhotoImage若仅作为局部变量存在，Python会在代码块执行完毕后回收该对象——尽管Tkinter的按钮控件引用了它，但Tkinter对图像的引用是弱引用，无法阻止Python的垃圾回收行为。当图像被回收后，按钮失去图像资源，就会出现图片消失、按钮状态异常的情况。

解决方法 #

将PhotoImage对象保存为类的实例属性，让Python保持对它的强引用，避免被垃圾回收：

import tkinter as tk
from tkinter import colorchooser

class MainGUI(tk.Tk):
    def __init__(self):
        super().__init__()
        addImage = r'C:\Documents\Scripting\VisualStudio\ClispiPy\ClispiPy\Images\Add.png'
        # 将PhotoImage保存为实例属性
        self.addPhoto = tk.PhotoImage(file = addImage)
        # 按钮使用实例属性中的图像
        tk.Button(self, image=self.addPhoto, command=self.open_sub_gui).pack(pady=20)

    def open_sub_gui(self):
        col = colorchooser.askcolor(title='Select Color')
        return

if __name__ == "__main__":
    main_gui = MainGUI()
    main_gui.mainloop()

补充说明 #

• 文本按钮无此问题，是因为按钮的文本内容由Tkinter内部管理，不存在Python层面的垃圾回收风险。
• 若需同时显示文本和图片，可使用按钮的compound参数（如compound=tk.LEFT），但同样要确保PhotoImage对象持有强引用。

内容的提问来源于stack exchange，提问作者Cole Pratt