如何在Tkinter TreeView列中跨平台显示样式统一的复选框？

核心思路 #

放弃UTF-8符号方案，直接在TreeView目标列的单元格中嵌入ttk.Checkbutton，通过自定义ttk样式统一跨平台外观，同时绑定事件同步复选框状态与TreeView数据，彻底解决符号不统一、Linux显示异常、编辑控件样式不一致的问题。

实现代码与说明 #

1. 自定义统一风格的复选框样式 #

通过ttk.Style定义跨平台一致的复选框样式，规避系统默认样式差异：

import tkinter as tk
from tkinter import ttk

root = tk.Tk()
style = ttk.Style(root)

# 自定义复选框样式，统一跨平台外观
style.configure("TreeCheck.TCheckbutton",
                padding=(2, 2),
                indicatorcolor="#ffffff",
                indicatorsize=12)
style.map("TreeCheck.TCheckbutton",
          background=[("active", "#e0e0e0"), ("pressed", "#c0c0c0")],
          indicatorcolor=[("selected", "#0078d7")])

2. 初始化TreeView与测试数据 #

创建TreeView并插入含布尔列的测试数据：

# 创建TreeView，包含示例列（"选中"列为布尔列）
tree = ttk.Treeview(root, columns=("名称", "选中", "备注"), show="headings")
tree.heading("名称", text="项目名称")
tree.heading("选中", text="是否选中")
tree.heading("备注", text="备注信息")
tree.column("名称", width=150)
tree.column("选中", width=80, anchor="center")
tree.column("备注", width=200)

# 插入测试数据，"选中"列用布尔值存储状态
test_data = [
    ("项目A", True, "测试项目1"),
    ("项目B", False, "测试项目2"),
    ("项目C", True, "测试项目3")
]
for item in test_data:
    tree.insert("", tk.END, values=item)

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

3. 嵌入复选框并同步状态 #

编写函数在"选中"列单元格放置复选框，绑定事件同步TreeView数据与复选框状态：

# 存储复选框与TreeView条目的映射关系
check_mapping = {}

def place_checkboxes(event=None):
    # 清除已存在的复选框
    for cb in check_mapping.values():
        cb.destroy()
    check_mapping.clear()

    # 遍历所有条目，在"选中"列放置复选框
    for item in tree.get_children():
        bbox = tree.bbox(item, "选中")
        if not bbox:
            continue
        x, y, width, height = bbox

        # 创建复选框并居中放置
        var = tk.BooleanVar(value=tree.item(item, "values")[1])
        cb = ttk.Checkbutton(tree, variable=var, style="TreeCheck.TCheckbutton")
        cb.place(x=x + (width - cb.winfo_reqwidth())//2, 
                 y=y + (height - cb.winfo_reqheight())//2)

        # 绑定状态变化事件，同步TreeView数据
        def on_check_change(var, item=item):
            tree.set(item, "选中", var.get())

        var.trace_add("write", lambda *args, var=var, item=item: on_check_change(var, item))
        check_mapping[item] = cb

# 绑定TreeView布局变化事件，确保复选框位置正确
tree.bind("<Configure>", place_checkboxes)
tree.bind("<MouseWheel>", place_checkboxes)
# 初始化放置复选框
place_checkboxes()

root.mainloop()

方案优势 #

• 跨平台一致性：自定义样式确保Windows和Linux下复选框外观统一，无系统默认样式差异。
• 彻底解决符号问题：抛弃UTF-8符号方案，避免大小不匹配、Linux显示为空的问题。
• 样式统一：显示与编辑使用同一套复选框样式，视觉完全一致。
• 灵活可控：可通过调整ttk.Style参数自定义复选框的颜色、大小、内边距等样式。

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