PySide6 QTableWidget列排序问题：排序异常与性能优化求助

问题1：setData填充后出现空单元格的原因 #

当你使用table_item.setData(Qt.DisplayRole, current_value_rounded)传入浮点数值时，QTableWidgetItem默认不会自动将浮点值格式化为可显示的字符串。Qt的DisplayRole虽然支持数值类型，但直接传入浮点值可能导致控件无法正确解析渲染，从而显示为空。

正确的做法是同时设置显示文本和用于排序的原始数值：用格式化字符串设置Item的显示文本（保证显示两位小数），将浮点数值存储在Qt.UserRole中（用于排序时的数值比较），这样既保证显示正常，又能实现正确排序。

修改后的填充代码示例：

# 批量插入前先关闭排序，避免频繁UI刷新
self.table_widget.setSortingEnabled(False)

current_row_count = self.table_widget.rowCount()
self.table_widget.insertRow(current_row_count)
column_count = 0

for column in results_df:
    current_value = results_df[column].values[0]
    if column_count != 0:
        # 设置显示文本（保留两位小数）
        display_text = f"{current_value:.2f}"
        table_item = QTableWidgetItem(display_text)
        # 存储浮点数值到UserRole，用于排序
        table_item.setData(Qt.UserRole, round(current_value, 2))
    else:
        # 第一列直接设置文本
        table_item = QTableWidgetItem(str(current_value))
    
    table_item.setFlags(table_item.flags() & ~Qt.ItemIsEditable)
    table_item.setTextAlignment(Qt.AlignCenter)
    self.table_widget.setItem(current_row_count, column_count, table_item)
    column_count += 1

# 插入完成后重新开启排序
self.table_widget.setSortingEnabled(True)

问题2：排序速度慢的优化方案 #

数千行数据排序卡顿的核心原因是：QTableWidget基于UI元素排序，排序时实时刷新UI，且默认按文本比较的逻辑效率低。可以通过以下方式优化：

方案1：排序时禁用UI更新 #

在排序前后临时关闭排序功能，避免实时刷新UI导致的卡顿：

def sort_table(self, column):
    current_order = self.table_widget.horizontalHeader().sortIndicatorOrder()
    new_order = Qt.DescendingOrder if current_order == Qt.AscendingOrder else Qt.AscendingOrder

    # 排序前关闭UI排序更新
    self.table_widget.setSortingEnabled(False)
    # 针对非第一列，使用UserRole的数值排序
    if column != 0:
        # 自定义排序逻辑，基于UserRole的数值
        self.table_widget.sortItems(column, new_order, lambda item1, item2: 
            (item1.data(Qt.UserRole) - item2.data(Qt.UserRole)) * (-1 if new_order == Qt.DescendingOrder else 1))
    else:
        # 第一列按文本排序
        self.table_widget.sortItems(column, new_order)
    # 排序完成后重新开启排序
    self.table_widget.setSortingEnabled(True)
    # 更新排序指示器
    self.table_widget.horizontalHeader().setSortIndicator(column, new_order)

方案2：使用QSortFilterProxyModel（推荐） #

对于大量数据，改用模型视图架构（QTableView + QStandardItemModel + QSortFilterProxyModel），将数据存储在模型中，由代理模型处理排序，性能远高于直接操作QTableWidget：

1. 初始化模型和代理：

from PySide6.QtCore import QSortFilterProxyModel, Qt
from PySide6.QtGui import QStandardItemModel, QStandardItem

# 初始化模型和代理
self.model = QStandardItemModel()
self.proxy_model = QSortFilterProxyModel()
self.proxy_model.setSourceModel(self.model)
# 设置排序时使用UserRole的数值
self.proxy_model.setSortRole(Qt.UserRole)
# 将代理模型绑定到表格
self.table_widget.setModel(self.proxy_model)

2. 填充数据到模型：

self.table_widget.setSortingEnabled(False)
self.model.clear()  # 清空旧数据

# 设置列数
self.model.setColumnCount(len(results_df.columns))
# 设置表头（如果需要）
self.model.setHorizontalHeaderLabels(results_df.columns)

# 批量插入行数据
for _, row_data in results_df.iterrows():
    items = []
    for col_idx, value in enumerate(row_data):
        if col_idx == 0:
            item = QStandardItem(str(value))
        else:
            display_text = f"{value:.2f}"
            item = QStandardItem(display_text)
            item.setData(round(value, 2), Qt.UserRole)
        item.setFlags(item.flags() & ~Qt.ItemIsEditable)
        item.setTextAlignment(Qt.AlignCenter)
        items.append(item)
    self.model.appendRow(items)

self.table_widget.setSortingEnabled(True)

3. 表头点击排序（QTableView默认支持，无需额外代码，若需自定义顺序可绑定事件）：

self.table_widget.horizontalHeader().sectionClicked.connect(lambda col: 
    self.proxy_model.sort(col, 
        Qt.DescendingOrder if self.proxy_model.sortOrder() == Qt.AscendingOrder else Qt.AscendingOrder))

方案3：批量插入数据 #

避免逐行插入时频繁刷新UI：插入所有数据前先关闭sortingEnabled，插入完成后再开启，减少UI刷新次数（上述代码已包含此逻辑）。

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