Python3 Tkinter点击切换图片时图片变白按钮无响应问题

问题复现 #

开发点击按钮切换图片的Tkinter功能时，按钮仅能响应首次点击，点击后按钮上的图片变为纯白色，无法继续触发切换操作，问题复现代码如下：

# Modules
from tkinter import *
from PIL import Image, ImageTk

# Functions
def change_img():
    global curr_img
    global root
    global image1
    image1 = Image.open(f"Hamster {curr_img + 1}.jpg")
    image1 = image1.resize((100, 60))
    img1 = ImageTk.PhotoImage(image1)
    btn.configure(image=img1, command=change_img)
    root.update()
    curr_img += 1

# Main Window
root = Tk()
root.title("Picture Change")
root.geometry("300x150")
root.config(bg="black")

# Adding Objects
curr_img = 1
Label(root, text="My Favorite Animal", fg="white", bg="black", font=("Arial bold", "20")).pack() # This is a label.
image1 = Image.open("Hamster 1.jpg") # First we open the image and save it into a variable.
image1 = image1.resize((100,60)) # Resizes the image.
img1 = ImageTk.PhotoImage(image1) # Create a ImageTK object from the image1 variable.
btn = Button(image = img1, command=change_img) # Create a label and put the image into it.
btn.pack() # Pack the label that contains the image. Now, we repeat the process.

# Mainloop
root.mainloop()

核心原因 #

Tkinter的PhotoImage对象如果没有持久引用，会被Python垃圾回收机制自动释放：change_img函数内定义的img1是局部变量，函数执行完毕后变量就会被销毁，按钮找不到绑定的图片资源就会显示纯白色，并非点击事件本身失效。
原代码还存在两处冗余逻辑：

• 按钮初始化时已经绑定command=change_img，每次切换图片重复配置command属于无效操作
• 不需要手动调用root.update()，Tkinter主循环会自动完成界面渲染刷新

可直接运行的修复代码 #

from tkinter import *
from PIL import Image, ImageTk

# 替换为你实际的仓鼠图片总数量，避免打开不存在的文件报错
TOTAL_IMAGE_COUNT = 2

def change_img():
    global curr_img
    # 图片序号循环：切换到最后一张后自动回到第一张
    curr_img = curr_img + 1 if curr_img < TOTAL_IMAGE_COUNT else 1
    img = Image.open(f"Hamster {curr_img}.jpg").resize((100, 60))
    # 关键：把PhotoImage绑定为按钮的自定义属性，保留引用防止被垃圾回收
    btn.tk_img = ImageTk.PhotoImage(img)
    btn.configure(image=btn.tk_img)

# 主窗口初始化
root = Tk()
root.title("Picture Change")
root.geometry("300x150")
root.config(bg="black")

# 组件初始化
curr_img = 1
Label(root, text="My Favorite Animal", fg="white", bg="black", font=("Arial bold", "20")).pack()
init_img = Image.open("Hamster 1.jpg").resize((100,60))
init_tk_img = ImageTk.PhotoImage(init_img)
btn = Button(image=init_tk_img, command=change_img)
btn.tk_img = init_tk_img # 绑定初始图片的引用，避免初始图被回收
btn.pack()

root.mainloop()

关键修改点 #

• 所有PhotoImage对象都绑定为按钮的自定义属性，保证资源引用全程存在，不会被垃圾回收
• 新增图片序号循环逻辑，避免序号溢出导致找不到对应文件抛出异常
• 删除冗余的重复command配置、手动update调用
• 简化了图片打开、缩放步骤的冗余变量写法

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