Tkinter按钮图片加载慢且集成PIL后不显示及报错问题求助

问题说明 #

我在Tkinter的选择窗口按钮中加载图片时，每次打开窗口要耗时5秒以上，调试时反复等待效率极低。尝试改用PIL的Image.open替代Tkinter原生PhotoImage，单独测试代码能正常显示图片，但整合到项目后按钮无法显示图片，关闭窗口还会触发报错。

原代码核心问题 #

1. 图片重复加载导致延迟：每次调用selection_window函数才加载图片，重复IO操作和缩放处理拖慢了窗口打开速度。
2. 图片对象被垃圾回收：用PIL加载图片后，没有将图片对象绑定到按钮的属性上，Python垃圾回收机制会回收临时图片对象，导致按钮无法显示图片。
3. 全局变量访问不安全：enable_button函数直接访问全局的button1/button2，窗口销毁时如果这些对象已被回收，会引发属性访问错误。

解决方案 #

• 预加载图片：在程序启动时就完成图片的加载和缩放，后续打开窗口直接复用，彻底解决加载延迟问题。
• 保留图片引用：将图片对象绑定到按钮的image属性上，防止被垃圾回收。
• 安全检查按钮状态：在enable_button中通过事件对象获取目标窗口，避免直接访问全局变量引发错误。

修正后的完整代码 #

from tkinter import *
from PIL import Image, ImageTk

root = Tk()
root.title("Projectile motion")
root.geometry("800x500")
root.resizable(False, False)
scale_label = None

# 预加载并处理图片，程序启动时只执行一次
def preload_images():
    # 加载并缩放图片，可根据需求调整尺寸参数
    scenario1_img = Image.open("scenario 1.png")
    scenario1_img = scenario1_img.resize((125, 125), Image.Resampling.LANCZOS)
    global img1
    img1 = ImageTk.PhotoImage(scenario1_img)
    
    scenario2_img = Image.open("scenario 2.png")
    scenario2_img = scenario2_img.resize((125, 125), Image.Resampling.LANCZOS)
    global img2
    img2 = ImageTk.PhotoImage(scenario2_img)

# 执行预加载
preload_images()

def switch():
    page1.grid_forget()
    page2.grid(row=0, column=0, sticky="nsew")

page1 = Frame(root, width=800, height=500)
page2 = Frame(root, width=800, height=500, bg="azure3")
page1.grid(row=0, column=0, sticky="nsew")
page2.grid(row=0, column=0, sticky="nsew")

# 主页面元素
main_window_title = Label(page1, text="Projectile Motion Simulation", font=("Times New Roman bold", 35))
main_window_title.place(relx=0.13, rely=0.26)

main_window_button = Button(page1, text="Start", font=("Arial bold", 15), background="#ff0000", 
                            activebackground="#f08080", command=switch, height=4, width=20)
main_window_button.place(relx=0.5, rely=0.6, anchor="center")

# 说明页面元素
welcome_text = Label(page2, text="Welcome to Projectile Motion simulation", bg="azure3", font=("Times New Roman bold", 30))
welcome_text.place(relx=0, rely=0)

htp_text = Label(page2, text="How to play?", bg="azure3", font=("Times New Roman", 25))
htp_text.place(relx=0, rely=0.1)

instruction_text = ("1) Use sliders, checkboxes, and buttons to adjust the simulation\n" 
                    "2) Press 'Launch' button to show output values\n" 
                    "3) Press checkboxes to show values on animation window\n"
                    "4) Press 'projectile 1' and 'projectile 2' to switch between projectiles \n"
                    "5) Press 'Explanation' button to get the theory on projectile motion\n"
                    "6) Press 'Quiz' button to try a quiz on projectile motion\n"
                    "7) Press back button to close window")

htp2_text = Label(page2, text=instruction_text, font=("Times New Roman", 20), bg="azure3", justify='left', anchor='w')
htp2_text.place(relx=0, rely=0.2)

# 补充原代码缺失的next_button定义
next_button = Button(page2, text="Open Selection", command=selection_window, font=("Arial", 12))
next_button.place(relx=0.5, rely=0.8, anchor="center")

def enable_button(event):
    next_button["state"] = "normal"
    # 通过事件对象获取销毁的窗口，避免直接访问全局按钮变量
    destroyed_window = event.widget
    # 安全检查按钮是否存在
    for btn in [button1, button2] if 'button1' in globals() and 'button2' in globals() else []:
        try:
            if btn.winfo_exists():
                btn["state"] = "normal"
        except:
            pass

def vertical_animation():
    # 补充你的垂直动画逻辑
    pass

def animation_window(num):
    # 补充你的动画窗口逻辑
    pass

def selection_window():
    next_button["state"] = "disabled"
    
    selection_win = Toplevel()
    selection_win.title("Selection page")
    selection_win.config(width=500, height=500)
    selection_win.resizable(False, False)
    selection_win.bind("<Destroy>", enable_button)

    global button1, button2
    # 直接使用预加载好的图片，绑定引用到按钮防止被回收
    button1 = Button(selection_win, image=img1, command=vertical_animation)
    button1.image = img1
    button1.grid(row=0, column=0, padx=10, pady=10)

    button2 = Button(selection_win, image=img2, command=lambda: animation_window(1))
    button2.image = img2
    button2.grid(row=0, column=1, padx=10, pady=10)
    
    root.withdraw()

root.mainloop()

关键优化点 #

• 预加载图片：通过preload_images函数在程序启动时完成图片加载和缩放，避免每次打开选择窗口重复处理，彻底消除加载延迟。
• 引用保留：将预加载的图片对象绑定到按钮的image属性，防止Python垃圾回收回收图片资源，确保按钮正常显示图片。
• 安全的事件处理：enable_button函数通过事件对象获取被销毁的窗口，避免直接访问全局变量引发的错误，同时增加异常捕获处理，提升代码稳定性。

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