PyQt6：如何在QTableWidget单元格存储列表并解决排序对应问题

错误原因分析 #

你的代码报错源于两个问题：

• QTableWidgetItem的构造函数不支持直接传入列表作为参数；
• 调用QTableWidgetItem.setData的方式错误——这是实例方法，不能直接通过类调用，必须先创建Item实例。

正确实现步骤 #

1. 存储列表数据到单元格

创建QTableWidgetItem实例，通过setData方法用自定义角色（推荐Qt.UserRole）存储列表，这样不会影响单元格的显示（因为你要隐藏该列）。修改后的代码如下：

from PyQt5.QtCore import Qt

for x in range(globalStatLen):
    tableBrowse.insertRow(x)
    for y in range(rightLen):
        if y == 9:
            # 创建空Item，因该列隐藏无需显示文本
            item = QTableWidgetItem()
            # 用UserRole存储列表数据
            item.setData(Qt.UserRole, globalStats[x][y])
            tableBrowse.setItem(x, y, item)
        else:
            # 普通列转成字符串后创建Item
            tableBrowse.setItem(x, y, QTableWidgetItem(str(globalStats[x][y])))

2. 隐藏存储列表的列

填充完数据后，将第10列（索引9）隐藏：

tableBrowse.setColumnHidden(9, True)

3. 获取选中行的列表数据

当用户选中单元格时，通过行号获取对应隐藏列的Item，再用data(Qt.UserRole)取出存储的列表：

# 示例：选中单元格的槽函数
def on_cell_selected(row, col):
    item = tableBrowse.item(row, 9)
    if item:
        stored_list = item.data(Qt.UserRole)
        # 此处添加对列表数据的业务处理
        print(stored_list)

核心优势 #

把数据直接存在表格的Item中，不管表格如何排序、过滤（搜索），每个Item会跟随所在行移动，数据和行的对应关系始终保持一致，彻底解决数组索引错位的问题。

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