SQLite数据插入Tkinter表格异常：所有内容仅显示在单列

1. Treeview列配置不匹配 #

这是最常见的原因：初始化Treeview时columns参数没有正确定义所需列，或者列数量与SQL查询的字段数不对应。

错误示例：

# 错误：columns仅定义一个列，却要插入多字段数据
tree = ttk.Treeview(root, columns=("single_col"))
tree.heading("#0", text="ID")
tree.heading("single_col", text="内容")

正确配置（假设SQL表有id, name, email三个字段）：

# columns定义对应#0以外的列，数量与查询字段数一致
tree = ttk.Treeview(root, columns=("name", "email"))
# 设置每列表头
tree.heading("#0", text="ID")
tree.heading("name", text="用户名")
tree.heading("email", text="邮箱")
# 可选：设置列宽
tree.column("#0", width=60)
tree.column("name", width=120)
tree.column("email", width=180)

2. 插入数据时参数错误 #

如果插入数据时把整行数据作为单个值传给values，或者错误地将所有内容塞到text参数（对应#0列），就会导致所有数据挤到一列。

错误示例1：把整行元组当成单个值传入values

cursor.execute("SELECT id, name, email FROM users")
for row in cursor.fetchall():
    # 错误：values接收单个元组元素，所有数据合并到一列
    tree.insert("", "end", text=row[0], values=row)

错误示例2：把所有内容塞到text参数

for row in cursor.fetchall():
    # 错误：整行数据都放到#0列里
    tree.insert("", "end", text=str(row))

正确插入方式：

cursor.execute("SELECT id, name, email FROM users")
for row in cursor.fetchall():
    # text对应#0列（ID），values对应columns定义的name和email列，拆成对应元素
    tree.insert("", "end", text=row[0], values=(row[1], row[2]))

3. SQL查询结果处理错误 #

如果把查询返回的行转成字符串或错误格式，也会导致数据无法正确分配到列。

错误示例：

for row in cursor.fetchall():
    # 错误：把行转成单个字符串，values仅传一个值
    row_str = " | ".join(str(x) for x in row)
    tree.insert("", "end", text=row[0], values=(row_str,))

正确做法是直接使用查询返回的元组，按列对应拆分传入values。

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