PySide2中QListView.setRootIndex结合自定义模型异常问题

核心结论 #

• 同一模型完全可以给多个视图使用，这正是MVC设计思想的核心优势——模型与视图分离，多视图共享同一数据源状态，完全符合Qt模型视图架构的标准用法。
• setRootIndex的用法没问题，问题出在自定义QAbstractItemModel的实现逻辑上，尤其是rowCount和index方法对父索引的处理错误，导致ListView无法正确获取根索引下的子项数据。

问题原因 #

ListView设置根索引后，会请求该索引下的所有直接子项。如果你的模型存在以下问题，就会出现“仅显示一个子项”“偏移空白”的现象：

1. rowCount方法在父索引有效时，没有返回对应父项的子项数量，而是错误返回了顶层项的总数；
2. index方法生成子项索引时，没有正确使用父索引的信息，导致子项索引的位置计算错误。

修正后的示例模型代码 #

以下是正确实现的两级自定义模型，可同时适配TreeView和ListView：

from PySide2.QtCore import QAbstractItemModel, QModelIndex, Qt
from PySide2.QtWidgets import QApplication, QTreeView, QListView, QHBoxLayout, QWidget

class TwoLevelModel(QAbstractItemModel):
    def __init__(self, data, parent=None):
        super().__init__(parent)
        # 数据结构：[[顶层项名称, [子项列表]], ...]
        self._data = data

    def index(self, row, column, parent=QModelIndex()):
        if not self.hasIndex(row, column, parent):
            return QModelIndex()
        
        # 父索引无效时，返回顶层项的索引
        if not parent.isValid():
            return self.createIndex(row, column, self._data[row])
        # 父索引有效时，返回父项的子项索引
        parent_data = parent.internalPointer()
        return self.createIndex(row, column, parent_data[1][row])

    def parent(self, index):
        if not index.isValid():
            return QModelIndex()
        
        child_data = index.internalPointer()
        # 遍历顶层项，找到当前子项所属的父项
        for row, parent_item in enumerate(self._data):
            if child_data in parent_item[1]:
                return self.createIndex(row, 0, parent_item)
        return QModelIndex()

    def rowCount(self, parent=QModelIndex()):
        if parent.column() > 0:
            return 0
        
        if not parent.isValid():
            # 返回顶层项数量
            return len(self._data)
        else:
            # 返回父项的子项数量
            parent_data = parent.internalPointer()
            return len(parent_data[1])

    def columnCount(self, parent=QModelIndex()):
        return 1

    def data(self, index, role=Qt.DisplayRole):
        if not index.isValid():
            return None
        
        item_data = index.internalPointer()
        if role == Qt.DisplayRole:
            # 顶层项取名称字段，子项直接返回内容
            return item_data[0] if isinstance(item_data, list) else item_data
        return None

if __name__ == "__main__":
    app = QApplication([])
    # 测试数据
    test_data = [
        ["顶层项1", ["子项1-1", "子项1-2", "子项1-3"]],
        ["顶层项2", ["子项2-1", "子项2-2"]],
        ["顶层项3", ["子项3-1"]]
    ]

    model = TwoLevelModel(test_data)
    
    tree_view = QTreeView()
    tree_view.setModel(model)
    
    list_view = QListView()
    list_view.setModel(model)
    
    # 关联点击信号
    tree_view.clicked.connect(list_view.setRootIndex)
    
    layout = QHBoxLayout()
    layout.addWidget(tree_view)
    layout.addWidget(list_view)
    
    window = QWidget()
    window.setLayout(layout)
    window.show()
    app.exec_()

关键修正点 #

1. rowCount方法：明确区分父索引是否有效，父索引有效时返回对应父项的子项数量，而非顶层项总数。
2. index方法：正确根据父索引生成子项的索引，父有效时从父项的子列表中取对应元素。
3. parent方法：正确反向查找子项所属的父项索引，保证模型层级关系的正确性。

用该模型测试，点击TreeView的顶层项后，ListView会正确显示该顶层项的所有子项，无偏移和缺失问题。

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