PyQt5中SQLite表数据无法显示在QTableWidget的问题求助

1. 未正确设置表格行列数 #

从SQLite拿到数据后，必须先指定QTableWidget的行数和列数，否则数据无法渲染到界面上。比如你查到15行数据，先获取表的字段数作为列数：

# 假设cursor.fetchall()拿到的数据存在data里，columns是字段名列表
row_count = len(data)
col_count = len(columns)
self.tableWidget.setRowCount(row_count)
self.tableWidget.setColumnCount(col_count)
# 设置表头显示字段名
self.tableWidget.setHorizontalHeaderLabels(columns)

2. 填充数据时索引或类型错误 #

填充单元格要注意两个点：一是行列索引从0开始，别搞反或越界；二是SQLite返回的数值类型要转成字符串，QTableWidgetItem只接受字符串或兼容类型：

for row_idx, row_data in enumerate(data):
    for col_idx, cell_data in enumerate(row_data):
        # 把数据转成字符串后创建表格项
        item = QTableWidgetItem(str(cell_data))
        self.tableWidget.setItem(row_idx, col_idx, item)

3. UI文件引用错误 #

如果是用Designer转的py文件，要确保主程序里正确实例化UI类，并且操作的是UI里的tableWidget对象，不是自己新建的空表格：

from ui_teacher_form import Ui_MainWindow  # 替换成你的UI文件名

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        # 必须用self.ui.tableWidget来操作，不能直接用self.tableWidget
        self.load_data()

4. 未触发表格刷新 #

有时候数据填充后需要手动触发刷新，确保界面更新：

# 刷新表格视图
self.tableWidget.viewport().update()

5. 表格被遮挡或不可见 #

检查Designer里的表格控件是否被其他控件覆盖，或者设置了visible为False，也可以在代码里强制设置尺寸：

self.tableWidget.setGeometry(20, 20, 780, 560)  # 根据你的界面调整位置和大小

6. 数据变量作用域问题 #

确认你print的data和填充表格用的是同一个变量，避免函数内部查询的数据无法传递到填充逻辑里。

完整示例片段 #

import sqlite3
from PyQt5.QtWidgets import QMainWindow, QTableWidgetItem
from ui_teacherform import Ui_MainWindow  # 替换为你的UI文件

class TeacherWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        self.load_teacher_data()

    def load_teacher_data(self):
        # 连接数据库
        conn = sqlite3.connect('your_db.db')  # 替换成你的数据库路径
        cursor = conn.cursor()
        cursor.execute("SELECT * FROM teacher")
        data = cursor.fetchall()
        # 获取字段名作为表头
        columns = [desc[0] for desc in cursor.description]
        conn.close()

        # 打印数据确认（你已经在做这一步）
        print(data)

        # 设置表格行列
        self.ui.tableWidget.setRowCount(len(data))
        self.ui.tableWidget.setColumnCount(len(columns))
        self.ui.tableWidget.setHorizontalHeaderLabels(columns)

        # 填充数据
        for row in range(len(data)):
            for col in range(len(columns)):
                item = QTableWidgetItem(str(data[row][col]))
                self.ui.tableWidget.setItem(row, col, item)

        # 强制刷新表格
        self.ui.tableWidget.viewport().update()

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