Tkinter TreeView图标显示异常：仅首列可见，第二列无法展示

问题核心原因 #

Tkinter TreeView 的原生 item 配置中，image 参数仅对第一列生效，其他列没有直接设置图标的内置属性，这就是你第二列点击功能正常但图标不显示的根本原因。

解决方案：自定义单元格绘制 #

要在第二列显示图标，需要通过事件绑定+手动绘制的方式实现，以下是可直接复用的代码示例：

import tkinter as tk
from tkinter import ttk

root = tk.Tk()
root.geometry("400x300")

# 初始化TreeView，定义列
tree = ttk.Treeview(root, columns=("Name", "Get/Checked"), show="headings")
tree.heading("Name", text="名称")
tree.heading("Get/Checked", text="选择状态")
tree.column("Name", width=200)
tree.column("Get/Checked", width=150)
tree.pack(fill="both", expand=True)

# 加载图标（注意：要保留全局引用避免被GC回收）
check_icon = tk.PhotoImage(file="check.png")  # 替换为你的勾选图标路径
uncheck_icon = tk.PhotoImage(file="uncheck.png")  # 替换为你的未勾选图标路径

# 存储每个项的勾选状态（也可以用TreeView的tag标记）
item_states = {}

# 批量添加测试项
for i in range(5):
    item_id = tree.insert("", "end", values=(f"项目{i+1}", ""))
    item_states[item_id] = False

# 绘制图标的核心函数
def render_column_icons(event):
    # 遍历所有可见项
    for item in tree.get_children():
        # 获取第二列的单元格坐标
        bbox = tree.bbox(item, "Get/Checked")
        if not bbox:  # 单元格不可见时跳过
            continue
        x, y, w, h = bbox
        # 根据状态选择图标
        icon = check_icon if item_states[item] else uncheck_icon
        # 在单元格中心绘制图标
        tree.create_image(x + w//2, y + h//2, image=icon, anchor="center", tags=(f"icon_{item}",))

# 绑定重绘触发事件（窗口大小变化、组件显示时重绘）
tree.bind("<Configure>", render_column_icons)
tree.bind("<Map>", render_column_icons)

# 处理第二列点击，切换勾选状态并重绘图标
def toggle_check_state(event):
    item = tree.identify_row(event.y)
    column = tree.identify_column(event.x)
    if column == "#2" and item:
        item_states[item] = not item_states[item]
        # 先清除旧图标再重绘
        tree.delete(f"icon_{item}")
        render_column_icons(event)

tree.bind("<Button-1>", toggle_check_state)

root.mainloop()

注意事项 #

1. 图标引用回收问题：必须将图标对象保留在全局作用域（如示例中的check_icon），否则Python垃圾回收会销毁图标，导致显示空白。
2. 重绘时机：除了<Configure>和<Map>事件，还可以绑定<MouseWheel>、<KeyPress>等事件，确保滚动、键盘操作后图标正常显示。
3. 性能优化：如果列表项很多，建议只重绘可见区域的项，避免遍历所有项导致卡顿。

后续：列添加上下箭头实现顺序调整 #

同样用自定义绘制+事件绑定的方式实现，核心思路如下：

1. 新增一列（如"排序"），在该列单元格绘制上下箭头图标。
2. 绑定点击事件，判断点击的是上箭头还是下箭头，调用tree.move()方法调整项的位置。

代码片段示例：

# 新增排序列
tree["columns"] = ("Name", "Get/Checked", "排序")
tree.heading("排序", text="调整顺序")
tree.column("排序", width=80)

# 加载上下箭头图标
up_icon = tk.PhotoImage(file="up.png")
down_icon = tk.PhotoImage(file="down.png")

# 修改render_column_icons函数，新增排序列图标绘制
def render_column_icons(event):
    for item in tree.get_children():
        # 绘制第二列图标（同上逻辑）
        bbox = tree.bbox(item, "Get/Checked")
        if bbox:
            x, y, w, h = bbox
            icon = check_icon if item_states[item] else uncheck_icon
            tree.create_image(x + w//2, y + h//2, image=icon, anchor="center", tags=(f"icon_{item}",))
        
        # 绘制排序列上下箭头
        sort_bbox = tree.bbox(item, "排序")
        if sort_bbox:
            x, y, w, h = sort_bbox
            # 绘制上箭头（上半部分）
            tree.create_image(x + w//2, y + h//4, image=up_icon, anchor="center", tags=(f"up_{item}",))
            # 绘制下箭头（下半部分）
            tree.create_image(x + w//2, y + 3*h//4, image=down_icon, anchor="center", tags=(f"down_{item}",))

# 排序操作函数
def adjust_item_order(event):
    item = tree.identify_row(event.y)
    column = tree.identify_column(event.x)
    if column != "#3" or not item:
        return
    parent = tree.parent(item)
    current_idx = tree.index(item)
    # 判断点击的是上箭头还是下箭头（通过y坐标判断）
    bbox = tree.bbox(item, "排序")
    if event.y < bbox[1] + bbox[3]/2:
        # 上移
        if current_idx > 0:
            tree.move(item, parent, current_idx-1)
    else:
        # 下移
        total_items = len(tree.get_children(parent))
        if current_idx < total_items - 1:
            tree.move(item, parent, current_idx+1)
    # 重绘图标（可选，因移动后位置变化可能需要刷新）
    render_column_icons(event)

# 绑定点击事件，区分第二列和排序列操作
tree.bind("<Button-1>", lambda e: toggle_check_state(e) if tree.identify_column(e.x)=="#2" else adjust_item_order(e))

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