Tkinter循环批量放置图片全部重叠在最后位置问题求解

问题原因 #

• 该问题和Label()类本身无关，是Tkinter的PhotoImage对象垃圾回收机制导致的。
• Tkinter不会主动持有图片对象的强引用，你在循环中创建的mood_img_resized是局部变量，每轮循环结束后没有其他变量引用该对象，就会被Python的垃圾回收机制清理，对应的Label就会丢失图片资源。
• 按钮逻辑可以正常生效是因为按钮使用文本属性，不需要额外维护第三方资源的引用，不存在垃圾回收的问题。
• 额外注意：place()、pack()、grid()三种布局方法的返回值都是None，你写的mood_img_label = Label(...).place(...)实际拿到的是None，也没有保留Label对象的引用，进一步导致图片引用丢失。

解决方案 #

两种常用修复方案，任选其一即可：

方案1：用全局列表保留所有图片引用 #

提前定义一个列表，把循环中生成的所有PhotoImage对象存入列表，确保程序运行期间引用不会丢失：

# 提前定义全局列表存储图片引用
mood_image_refs = []

for count, mood in enumerate(mood_options):
    mood_img = Image.open(f"img/{mood}.png")
    mood_img_copy = mood_img.resize(img_size, Image.ANTIALIAS)
    mood_img_resized = ImageTk.PhotoImage(mood_img_copy)
    # 存入列表保留引用
    mood_image_refs.append(mood_img_resized)
    # 先创建Label对象，再调用布局方法
    mood_img_label = Label(root, image=mood_img_resized)
    mood_img_label.place(relx=spacing*(count+1), rely=0.35)

方案2：将图片绑定到Label对象属性 #

把PhotoImage对象直接绑定到对应Label的自定义属性上，只要Label对象存活，图片引用就不会被清理：

for count, mood in enumerate(mood_options):
    mood_img = Image.open(f"img/{mood}.png")
    mood_img_copy = mood_img.resize(img_size, Image.ANTIALIAS)
    mood_img_resized = ImageTk.PhotoImage(mood_img_copy)
    mood_img_label = Label(root, image=mood_img_resized)
    # 绑定到Label属性保留引用
    mood_img_label.mood_img = mood_img_resized
    mood_img_label.place(relx=spacing*(count+1), rely=0.35)

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