Python Tkinter Treeview文件节点图标仅最后显示且展开消失问题求助

我一眼就看出这是Tkinter和Python垃圾回收机制交互时的经典坑！

问题根源 #

1. 实例变量被重复覆盖：你用self.pic存储每个文件的图标，但每次循环都会把这个变量替换成新的PhotoImage对象。之前创建的图标对象因为没有其他引用，会被Python的垃圾回收器直接销毁，所以只有最后一个文件的图标能存活下来。
2. 展开时图标丢失：当你展开节点时，Treeview会重新渲染节点内容，但之前的图标已经被回收了，自然就显示不出来了。

解决方案：保留所有图标引用 #

我们需要给每个PhotoImage对象都保留独立的引用，不让垃圾回收器盯上它。最简单的方式是在类里维护一个容器来存储这些引用。

步骤1：初始化引用容器

在你的类的__init__方法里添加一个容器，用来保存所有图标引用：

def __init__(self, ...):
    # 你的其他初始化代码（比如创建Treeview等）
    self.icon_references = []  # 用列表存储所有图标引用

步骤2：修改populate_tree函数

把原来的self.pic改成局部变量，然后将每个新创建的图标添加到引用列表中：

def populate_tree(self, parent, fullpath, children):
    for child in children:
        cpath = os.path.join(fullpath, child).replace('\\', '/')
        if os.path.isdir(cpath):
            cid = self.tree.insert(parent, END, text=child, values=[cpath, 'directory'])
            self.tree.insert(cid, END, text='dummy')
        else:
            if child != "Thumbs.db":
                # 创建图标对象
                file_icon = ImageTk.PhotoImage(file=cpath)
                # 将图标引用存入列表，避免被垃圾回收
                self.icon_references.append(file_icon)
                # 插入节点时使用这个图标
                self.tree.insert(
                    parent, 
                    END, 
                    text=child, 
                    image=file_icon, 
                    values=[cpath, 'file', '{} bajtów'.format(os.stat(cpath).st_size)]
                )

进阶优化（可选）

如果需要更精准地管理图标（比如后续可以根据路径删除对应图标），可以用字典来存储，键为文件路径，值为图标对象：

# 初始化时
self.icon_references = {}

# 在populate_tree里
file_icon = ImageTk.PhotoImage(file=cpath)
self.icon_references[cpath] = file_icon

原理说明 #

Tkinter的PhotoImage对象依赖Python的引用计数来存活，只要有一个变量还引用着它，它就不会被销毁。通过把所有图标都存入类的容器中，我们确保了每个图标都有稳定的引用，Treeview在渲染（包括展开节点时的重新渲染）时就能正常显示它们了。

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