Qt QAbstractTableModel超71582788行程序卡顿问题求助

现象描述 #

• 当模型行数设为71,582,788时，应用运行流畅，滚动、CPU占用、内存消耗均符合预期
• 仅增加1行至71,582,789，程序立刻出现明显卡顿，无论初始化时设置还是后续动态修改行数都会触发
• 该问题在Mac OS和Windows系统上表现完全一致，列数多少不影响此临界行为

复现代码 #

from PySide6.QtWidgets import QTableView, QApplication, QMainWindow, QVBoxLayout, QWidget
from PySide6.QtCore import Qt, QAbstractTableModel
import sys
import time

class TableModel(QAbstractTableModel):
    def __init__(self, row_count, col_count, parent=None):
        super().__init__(parent)
        self.row_count = row_count
        self.col_count = col_count

    def rowCount(self, parent=None):
        return self.row_count

    def columnCount(self, parent=None):
        return self.col_count

    def data(self, index, role=Qt.ItemDataRole.DisplayRole):
        pass


class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Table Example")

        row_count = 71582789
        col_count = 300
        
        model = TableModel(row_count, col_count, self)

        table_view = QTableView(self)
        table_view.setModel(model)

        layout = QVBoxLayout()
        layout.addWidget(table_view)
        
        container = QWidget()
        container.setLayout(layout)
        self.setCentralWidget(container)
        self.resize(800, 600)


if __name__ == "__main__":
    app = QApplication(sys.argv)
    
    timestart = time.time()
    window = MainWindow()
    print(time.time()-timestart)
    
    window.show()
    print(time.time()-timestart)
    
    sys.exit(app.exec())

原因推测 #

这个临界值71582789对应2^26 + 2^25的边界（计算：67108864 + 4473925 = 71582789），大概率是Qt内部在处理视图索引、滚动范围计算或缓存区域时，遇到了32位整数运算的边界，或者触发了算法逻辑的切换——当行数超过这个值，原本高效的整数计算逻辑失效，转而进入未优化的分支，导致性能断崖式下跌。

可行解决方案 #

1. 分页加载：放弃一次性加载全量数据，改用分页模式，只在视图中渲染当前页的行数据，通过分页控件切换数据批次。
2. 严格虚拟滚动控制：确保QTableView的虚拟滚动逻辑正常工作（默认开启），可以显式设置table_view.setVerticalScrollMode(QAbstractItemView.ScrollPerPixel)，同时限制模型中实际存在的行数为当前视口可见行的几倍（比如前后各多加载20行），滚动时动态更新模型数据。
3. 自定义视图渲染：如果必须处理超大数据集，可自定义视图组件，手动计算当前视口的可见行范围，仅渲染这些行的数据，避免模型持有全量行数。
4. 升级Qt版本：检查是否是已知bug，尝试升级到最新版PySide6/Qt，看问题是否已被官方修复。

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