Tkinter单列网格布局无法保留所有图片，求助问题原因与解法

问题描述 #

我正在开发一款包含图片的小型日记程序，希望将图片排列在单列网格中。运行下方代码时，第一张图片可正常显示，但按下回车加载下一张时，前一张图片会消失，以此类推直至最后一张。注：代码中不会包含“Press Enter to continue”语句，它仅用于触发图片加载；print(image)用于显示正在处理的文件。我尝试过While、For循环，也查阅了相关技术帖子，但问题仍未解决。

import tkinter as tk
from tkinter import *
from tkinter import ttk
from tkinter import Frame, Menu
from PIL import Image, ImageTk
import os

root = tk.Tk()

root.geometry('750x1000')

root.resizable(0,0)
root.columnconfigure(0, weight=5)
root.columnconfigure(1, weight=5)
root.columnconfigure(2, weight=5)

photo_list =  []
photo_list =  ['zendo1.png','hadock2.png','moon.png','sun.png','sailboat-sunset.png']
n=0
i=0
j=0

while n < 5:
        
    img=Image.open(photo_list[n])
    img= img.resize((150,150),Image.ANTIALIAS)
    image=img  
         
    photoImg = ImageTk.PhotoImage(image)
    
    photo_label= Label(root, image = photoImg)   
    print (image)
    photo_label.grid(row=i, column=j)
    verif_step = input("Please Press Enter to Continue ")
    i=i+1
    #j=j+1  
       
    n += 1
    
root.mainloop()

问题原因 #

Tkinter的PhotoImage对象如果没有被Python变量持续引用，会被垃圾回收机制清理，导致对应的图片标签无法显示图片。代码里每次循环创建的photoImg和photo_label都是局部变量，循环结束后旧对象失去引用，被回收后图片就会消失。另外input()会阻塞Tkinter主事件循环，导致界面更新异常。

解决代码 #

import tkinter as tk
from PIL import Image, ImageTk

root = tk.Tk()
root.geometry('750x1000')
root.resizable(0,0)
root.columnconfigure(0, weight=5)

# 保存图片和标签对象，防止被垃圾回收
saved_photos = []
saved_labels = []

photo_list = ['zendo1.png','hadock2.png','moon.png','sun.png','sailboat-sunset.png']
current_index = 0
row_num = 0
col_num = 0

def load_next_image(event=None):
    global current_index, row_num, col_num
    if current_index >= len(photo_list):
        return
    
    # 加载并调整图片大小
    img = Image.open(photo_list[current_index])
    img = img.resize((150,150), Image.Resampling.LANCZOS)  # 替代废弃的ANTIALIAS
    photo_img = ImageTk.PhotoImage(img)
    
    # 创建标签并布局
    photo_label = tk.Label(root, image=photo_img)
    photo_label.grid(row=row_num, column=col_num)
    
    # 保存对象，保持引用
    saved_photos.append(photo_img)
    saved_labels.append(photo_label)
    
    print(img)
    row_num += 1
    current_index += 1

# 绑定回车键触发加载
root.bind('<Return>', load_next_image)

# 初始化加载第一张
load_next_image()

root.mainloop()

关键修改说明 #

• 新增saved_photos和saved_labels列表，存储每个PhotoImage和标签对象，避免被垃圾回收。
• 用Tkinter的事件绑定替代input()，不再阻塞主事件循环，确保界面正常更新。
• 替换已废弃的Image.ANTIALIAS为Image.Resampling.LANCZOS（适配PIL新版本）。

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