Tkinter Treeview行显示pyimage1而非实际图片问题求助

核心原因：图片对象被垃圾回收 #

Tkinter的PhotoImage（包括PIL.ImageTK.PhotoImage）依赖Tcl/Tk的内部引用，Python侧如果没有保留对图片对象的持久引用，垃圾回收会自动销毁图片，Treeview里就只会显示默认的pyimageX标识，这是最常见的问题。

具体解决步骤 #

1. 保留图片对象的全局/持久引用 #

不要在循环或函数内部临时创建图片对象后就丢弃，把所有图片对象存在一个全局列表或字典里，比如：

# 全局存储图片对象，避免被回收
saved_images = []

# 在解码图片的地方
for item in data_from_mongo:
    # Base64解码
    img_data = base64.b64decode(item['base64_img'])
    # 用PIL处理图片
    from PIL import Image, ImageTk
    import io
    img = Image.open(io.BytesIO(img_data))
    # 调整图片尺寸适配Treeview列宽（可选，比如缩放到50x50）
    img = img.resize((50, 50), Image.Resampling.LANCZOS)
    photo_img = ImageTk.PhotoImage(img)
    # 把图片对象存到全局列表
    saved_images.append(photo_img)
    # 插入Treeview
    tree.insert('', 'end', values=(item['name'], photo_img))

2. 确保Treeview列配置支持图片显示 #

Treeview的列默认是文本类型，需要确保插入图片的列配置合理：

# 创建Treeview时定义包含图片的列
tree = ttk.Treeview(root, columns=('name', 'avatar'), show='headings')
tree.heading('name', text='名称')
tree.heading('avatar', text='头像')
# 设置列宽足够显示图片
tree.column('avatar', width=60)

3. 排查图片尺寸问题 #

如果图片过大，超出Treeview列的宽度，可能会被隐藏。强制缩小图片到合适尺寸，用上面代码里的resize方法处理。

4. 验证图片对象的有效性 #

可以临时把图片显示在Label里测试，确认图片对象本身没问题：

test_label = ttk.Label(root, image=photo_img)
test_label.pack()
# 如果Label能显示，说明图片对象正常，问题出在Treeview的引用或配置

额外注意点 #

• 不要用tk.PhotoImage直接处理PNG以外的格式（比如JPG），必须用PIL的ImageTk.PhotoImage，否则会解码失败。
• 如果是在类中开发，把图片对象存在实例属性里（比如self.saved_images = []），比全局变量更规范。

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