如何让tkinter的Treeview行条目图标默认显示？

该异常由Tkinter PhotoImage实例的引用丢失触发：Python垃圾回收机制会自动销毁没有被持有的图像对象。
单独运行自定义控件脚本时，图标对象的作用域覆盖全运行周期，因此可以正常显示；跨脚本导入、嵌入到ttk.PanedWindow后，自定义控件初始化时生成的临时图标对象没有绑定到实例属性，引用计数归零后被回收，仅在交互触发Treeview重绘时会临时加载一次资源，节点关闭后重绘就无法找到对应图标。

按以下步骤修改即可实现图标默认正常显示：

• 所有Treeview用到的图标对象必须绑定到自定义控件的实例属性，禁止用局部变量存储图标
  错误写法示例：

  # __init__方法内的局部变量，方法执行结束后就会被回收
  folder_icon = tk.PhotoImage(file="folder.png")
  self.tree.insert("", "end", text="根目录", image=folder_icon, open=True)
  

  正确写法示例：

  # 绑定到self实例属性，只要控件实例存在，图标引用就不会丢失
  self.folder_icon = tk.PhotoImage(file="folder.png")
  self.tree.insert("", "end", text="根目录", image=self.folder_icon, open=True)
  

• 动态生成大量节点时，用实例级别的字典统一缓存所有图标，避免重复加载同时保证引用不丢失：

  class CustomTreeFrame(ttk.Frame):
      def __init__(self, parent):
          super().__init__(parent)
          self.icon_cache = {} # 实例全局缓存
          self.tree = ttk.Treeview(self)
          self.tree.grid(row=0, column=0, sticky="nsew")
          # 其余初始化逻辑
      
      def add_tree_node(self, parent_node, node_name, icon_path):
          if icon_path not in self.icon_cache:
              self.icon_cache[icon_path] = tk.PhotoImage(file=icon_path)
          self.tree.insert(parent_node, "end", text=node_name, image=self.icon_cache[icon_path], open=True)
  

• 若修改后仍存在初始加载不渲染的问题，在自定义控件初始化末尾添加强制重绘逻辑：

  # 所有节点添加完成后调用，触发Treeview全局重绘
  self.tree.update_idletasks()
  

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