必须显式设置show="headings"，否则表头不显示且数据错位；columns定义列标识符，heading()设置表头文本；插入数据须用insert("", "end", values=...)。
show="headings" 没设，表头和数据全消失
Treeview 默认 show 值是 "tree headings"，但这个模式下第一列会被当树节点渲染，其余列压根不显示——结果就是：你调了 heading()、插了数据，界面上只有一片空白或错位的单列。必须显式写 show="headings" 才能当纯表格用。
常见错误现象：
- 运行没报错，但窗口里什么都没看到
- 只显示一行空行，点不动、选不了
- 数据插进去了，但全挤在最左边一列，其他列内容不可见
实操建议：
- 初始化时直接传参：
ttk.Treeview(parent, columns=("id", "name"), show="headings") - 别依赖默认值，也别写成
show="headings tree"或拼错字符串 - 如果后续要加树形结构（比如带子项的目录），再切回
show="tree headings"，普通表格不需要
columns 和 heading() 混用导致表头为空
columns 参数只定义列的内部标识符（类似数据库字段名），不是显示文本。如果你写了 tree["columns"] = ("id", "name") 却没调 heading("id", text="编号")，那表头就永远是空的——Tkinter 不会自动把标识符转成中文。
实操建议：
- 列定义和表头设置必须分两步：先
["col1", "col2"]，再对每个列调一次heading() -
heading()的第一个参数必须和columns里定义的字符串完全一致，大小写、下划线都不能错 - 漏掉任意一列的
heading()，对应位置表头就留白，但数据仍会按顺序填进去（容易误以为“没插成功”）
insert() 用错参数，数据根本没进表格
插入新行必须用 insert()，且第一个参数得是父节点 ID。普通表格没有层级，父 ID 就是空字符串 ""；第二个参数是位置，常用 "end" 表示追加到底部；values= 才是你要塞的数据元组。
常见错误现象：
- 调了
set(item_id, column, value)，但表格没新增行（set()只能改已有行） - 直接写
tree.item(item_id)["values"] = (...)，界面无变化（返回的是只读副本） - 第一个参数传了具体 ID（如
"root"）却没提前创建该节点，报TclError: Item root not found
实操建议：
- 新增行统一用：
tree.insert("", "end", values=("1001", "张三", 25)) - 不要手动生成 ID，Tkinter 自动分配最稳；除非你要做父子关系，否则别碰
id=参数 - 确认
values元组长度和columns定义数量一致，多一个少一个都会错位
布局管理器没调用，控件压根不渲染
哪怕 Treeview 对象创建成功、数据也插进去了，如果忘了对它或它的父容器调用 pack()、grid() 或 place()，它就不会出现在窗口里——这是纯布局问题，和 Treeview 逻辑无关。
实操建议：
- 检查是否漏写了
tree.pack()或tree.grid(row=0, column=0) - 别在一个父容器里混用多个布局器（比如先
pack()又grid()），会导致整个容器内控件失效 - 如果 Treeview 套在
LabelFrame或Frame里，记得连父容器一起布局，例如：frame.grid()和tree.pack()
最容易被忽略的是：列宽没设，内容被截断成“看不见”。column() 必须显式调用，否则默认宽度为 0，哪怕数据插进去了也显示为空白。别指望 Tkinter 自动撑开列宽。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
