PyQt5重写QStandardItemModel的rowCount()出现异常问题求助

首先，这不是PyQt的Bug，而是你在扩展QStandardItemModel时违背了它的内部工作逻辑导致的问题。让我拆解一下核心原因：

为什么会出现这些问题？ #

1. rowCount的实现忽略父索引，且与内部数据不匹配
   QStandardItemModel是基于内部维护的QStandardItem列表来工作的，当你重写rowCount返回原行数+1时，模型内部实际并没有对应第3行的item。但视图会根据你返回的rowCount去请求第3行的索引，此时QStandardItemModel的index()方法无法生成有效的索引（因为没有对应的item），或者生成的索引在后续调用super().data()时会访问不存在的item，直接触发断言失败或内存访问错误——这就是你看到50%概率崩溃的原因。

   另外你的rowCount方法没有处理parent参数，虽然在表格视图下父索引都是无效的，但这会导致树形场景下的逻辑错误。

2. data和flags的断言限制了有效范围
   你在这两个方法里断言index.row() < 2，但rowCount返回3，当视图尝试渲染第3行时，index.row()会是2，直接触发断言崩溃。

正确的解决思路 #

QStandardItemModel是一个具体实现的模型，依赖内部的item集合来维持状态一致性，直接修改rowCount而不添加对应item的做法会打破这种一致性。你有几个更稳妥的选择：

方案1：直接添加实际的额外行（最简单） #

如果你的额外行不需要特殊逻辑，直接在初始化时添加一行空item即可，这样rowCount自然就是原行数+1，所有模型方法都会正常工作：

from PyQt5 import QtWidgets, QtGui, QtCore
class MyModel(QtGui.QStandardItemModel):
    def __init__(self):
        super().__init__()
        self.appendRow([QtGui.QStandardItem("Hi"), QtGui.QStandardItem("there")])
        self.appendRow([QtGui.QStandardItem("Hello"), QtGui.QStandardItem("world")])
        # 直接添加额外行
        self.appendRow([QtGui.QStandardItem("Extra"), QtGui.QStandardItem("Row")])

class Testing(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        model = MyModel()
        view = QtWidgets.QTableView(self)
        view.setModel(model)
        self.setCentralWidget(view)
        self.show()

if __name__ == '__main__':
    app = QtWidgets.QApplication([])
    test = Testing()
    raise SystemExit(app.exec_())

方案2：使用代理模型（最灵活，不修改原模型） #

如果额外行需要特殊的逻辑（比如不写入原模型、动态生成数据），推荐使用QIdentityProxyModel来包装原模型，代理模型负责添加额外行，完全不影响原模型的状态：

from PyQt5 import QtWidgets, QtGui, QtCore

class AddExtraRowProxyModel(QtCore.QIdentityProxyModel):
    def rowCount(self, parent=QtCore.QModelIndex()):
        # 仅根节点（表格的行）添加额外行
        if not parent.isValid():
            return super().rowCount(parent) + 1
        return super().rowCount(parent)
    
    def data(self, index: QtCore.QModelIndex, role: QtCore.Qt.ItemDataRole):
        if not index.isValid():
            return None
        
        # 判断是否是额外行
        source_row_count = super().rowCount()
        if index.row() == source_row_count:
            if role == QtCore.Qt.DisplayRole:
                # 为额外行的不同列返回自定义数据
                return ["Extra", "Row"][index.column()]
            # 其他角色（比如对齐、字体等）可以按需处理
            return None
        
        # 非额外行直接转发给原模型
        return super().data(index, role)
    
    def flags(self, index: QtCore.QModelIndex) -> QtCore.Qt.ItemFlags:
        source_row_count = super().rowCount()
        if index.row() == source_row_count:
            # 设置额外行的交互权限，比如可选、不可编辑
            return QtCore.Qt.ItemIsSelectable | QtCore.Qt.ItemIsEnabled
        return super().flags(index)

class Testing(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        # 原模型保持不变
        model = QtGui.QStandardItemModel()
        model.appendRow([QtGui.QStandardItem("Hi"), QtGui.QStandardItem("there")])
        model.appendRow([QtGui.QStandardItem("Hello"), QtGui.QStandardItem("world")])
        
        # 用代理模型包装原模型
        proxy_model = AddExtraRowProxyModel()
        proxy_model.setSourceModel(model)
        
        view = QtWidgets.QTableView(self)
        view.setModel(proxy_model)
        self.setCentralWidget(view)
        self.show()

if __name__ == '__main__':
    app = QtWidgets.QApplication([])
    test = Testing()
    raise SystemExit(app.exec_())

方案3：自定义QAbstractTableModel（完全可控） #

如果你的数据逻辑比较复杂，完全可以放弃QStandardItemModel，自己基于QAbstractTableModel实现，这样所有数据和行为都由你完全掌控：

from PyQt5 import QtWidgets, QtGui, QtCore

class MyModel(QtCore.QAbstractTableModel):
    def __init__(self):
        super().__init__()
        # 存储原数据
        self._data = [
            ["Hi", "there"],
            ["Hello", "world"]
        ]
        # 额外行数据
        self._extra_row = ["Extra", "Row"]
    
    def rowCount(self, parent=QtCore.QModelIndex()):
        return len(self._data) + 1
    
    def columnCount(self, parent=QtCore.QModelIndex()):
        return 2
    
    def data(self, index: QtCore.QModelIndex, role: QtCore.Qt.ItemDataRole):
        if not index.isValid():
            return None
        if role != QtCore.Qt.DisplayRole:
            return None
        
        if index.row() < len(self._data):
            return self._data[index.row()][index.column()]
        else:
            return self._extra_row[index.column()]
    
    def flags(self, index: QtCore.QModelIndex) -> QtCore.Qt.ItemFlags:
        if index.row() == len(self._data):
            return QtCore.Qt.ItemIsSelectable | QtCore.Qt.ItemIsEnabled
        return QtCore.Qt.ItemIsSelectable | QtCore.Qt.ItemIsEnabled | QtCore.Qt.ItemIsEditable

class Testing(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        model = MyModel()
        view = QtWidgets.QTableView(self)
        view.setModel(model)
        self.setCentralWidget(view)
        self.show()

if __name__ == '__main__':
    app = QtWidgets.QApplication([])
    test = Testing()
    raise SystemExit(app.exec_())

总结 #

QStandardItemModel适合快速构建简单的模型，但它的内部实现依赖item集合的一致性，直接修改rowCount而不添加对应item会导致模型状态混乱。选择上述方案中的任意一种，都能解决你遇到的崩溃和索引问题。

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