Tkinter Treeview能否在任意行列中显示指定样式的图片？

Tkinter的Treeview组件完全支持在任意指定行列添加图片，核心是利用ttk.Treeview的item配置结合图片对象来实现，以下是具体步骤和示例代码：

核心思路 #

Treeview的每个item可以为不同列单独设置image属性，你只需要提前加载好图片对象，在创建或修改item时指定对应列的图片即可。需要注意：图片对象必须保持引用（比如存为全局变量或类属性），否则会被Python的垃圾回收机制销毁，导致界面不显示图片。

完整代码示例 #

import tkinter as tk
from tkinter import ttk
from PIL import Image, ImageTk  # 处理JPG等非原生支持格式时需要

root = tk.Tk()
root.title("Treeview带图标示例")

# 加载并缩放图片（建议尺寸匹配行高，比如16x16）
# 方案1：用Tk原生PhotoImage（仅支持PNG/GIF）
# icon_status = tk.PhotoImage(file="status_icon.png").subsample(2, 2)
# 方案2：用PIL加载其他格式
icon_ok = ImageTk.PhotoImage(Image.open("ok_icon.jpg").resize((16, 16)))
icon_warn = ImageTk.PhotoImage(Image.open("warn_icon.png").resize((16, 16)))

# 创建Treeview并定义列
tree = ttk.Treeview(root, columns=("名称", "状态", "操作"), show="headings")
tree.heading("名称", text="文件名称")
tree.heading("状态", text="同步状态")
tree.heading("操作", text="操作")
tree.column("名称", width=150)
tree.column("状态", width=100)
tree.column("操作", width=80)

# 插入行，在指定列设置图片
# 示例1：直接在插入时给指定列加图片
tree.insert("", tk.END, values=("文档A.txt", "已同步", "查看"), image=icon_ok, column="状态")
# 示例2：先插入内容，后续修改指定列的图片
item = tree.insert("", tk.END, values=("文档B.jpg", "异常", "重试"))
tree.item(item, image=icon_warn, column="状态")
# 示例3：给第三列加图片
item2 = tree.insert("", tk.END, values=("文档C.zip", "等待", "取消"))
tree.item(item2, image=icon_ok, column="操作")

tree.pack(fill=tk.BOTH, expand=True)

# 保存图片引用，防止被回收
tree.icons = [icon_ok, icon_warn]

root.mainloop()

关键注意事项 #

• 图片引用保留：必须将PhotoImage或ImageTk.PhotoImage对象保存为全局变量、类属性或绑定到Treeview实例上（如示例中的tree.icons），避免被Python垃圾回收。
• 图片尺寸适配：建议将图片缩放到与Treeview行高匹配的大小（常见16×16、24×24），避免界面布局错乱。
• 多格式支持：Tk原生PhotoImage仅支持PNG和GIF，若需加载JPG、BMP等格式，需安装Pillow库（pip install pillow），通过ImageTk转换格式。

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