tkinter.ttk Treeview标题栏与数据列错位一列，如何正确修复？

核心成因 #

这种错位不属于代码bug，也不是控件运行异常，是Treeview的固定内置结构导致的：

• Treeview 天生预留了一个*ID为#0*的默认列，这个列是专门用来承载层级节点文本、展开折叠箭头的，不会被你通过tree['columns']自定义的列覆盖，也不会自动生成对应标题。
• 示例代码的逻辑里，第一份数据table[i][0]被赋值给了text参数，也就是塞给了这个默认的#0列；剩下的9份数据被传到了自定义的9个列里。而自定义列的标题是从#0列的右侧开始依次排布的，最终形成的布局是：
  • 最左侧：默认#0列（无标题，放第一份数据）
  • 往右依次：自定义列0（标题A，放第二份数据）、自定义列1（标题B，放第三份数据）……
    视觉上就会表现为「标题栏整体往右偏了一列，和数据错位」。

正确修复方式 #

根据是否需要保留Treeview的层级展开能力，选择对应方案即可：

方案1：不需要层级展开功能时，隐藏默认#0列 #

这是做纯表格展示时最常用的处理方式，不会产生额外的占位空白：

• 不要把第一份数据赋值给text参数，将全部要展示的数据统一传给values参数
• 按数据总长度定义columns属性，保证自定义列的数量和数据列数一致
• 单独把默认#0列的宽度设为0、禁止拉伸，完全隐藏这一列
  修改后的核心可运行代码：

import tkinter as tk
import tkinter.ttk as ttk
import random

n, m = 40, 10
table = []
for i in range(n):
    line = [random.randint(0, 999) for j in range(m)]
    table.append(line)


class Demo(tk.Tk):
    def __init__(self):
        super().__init__()
        tree = ttk.Treeview(self)
        tree.pack()
        # 定义m个自定义列，和数据列数对应
        tree['columns'] = list(range(m))
        # 隐藏默认的#0列
        tree.column('#0', width=0, stretch=False)
        # 循环插入所有数据，text留空，全量传给values
        for i in range(n):
            tree.insert('', 'end', text='', values=table[i])
        # 给所有自定义列设置宽度和标题
        headings = list('ABCDEFGHIJ')
        for j in range(m):
            tree.column(j, width=50, anchor='e')
            tree.heading(j, text=headings[j])


if __name__ == '__main__':
    Demo().mainloop()

方案2：需要保留#0列作为第一展示列 #

如果要用Treeview的层级展开能力，就需要给这个默认的#0列也设置对应的标题，不要让它空着，同时保证数据分配顺序和列标题顺序完全对齐：

• 给#0列设置对应标题：tree.heading('#0', text=headings[0])
• 第一份数据继续放在text参数里对应#0列，剩下的数据依次对应后面的自定义列标题
• 这种模式下就不会出现错位，因为#0列有了自己的标题，和它承载的数据是一一对应的。

注：临时偏移方案中采用的「在每行开头加空字符串对齐数据」的方法属于临时绕过，本质是把空值塞给#0列让它不显示内容，但会保留#0列预留的展开箭头占位，视觉上总会有多余的空白边距，不是最优解。

内容的提问来源于stack exchange，提问作者Mike - SMT