QTreeModel无法显示指定数据的问题排查请求

1. 检查模型columnCount方法实现 #

确保自定义模型（如QAbstractItemModel子类）的columnCount返回实际需要的列数，而非默认值。返回值错误会导致视图仅显示列序号：

def columnCount(self, parent=QModelIndex()):
    # 示例：返回实际业务需要的列数，比如3
    return 3

2. 验证data方法的返回逻辑 #

data方法是模型向视图提供数据的核心，需正确处理Qt.DisplayRole：

• 先判断索引是否有效（index.isValid()）
• 确保针对Qt.DisplayRole返回对应列的实际数据，而非列索引

错误示例（返回列号而非数据）：

def data(self, index, role=Qt.DisplayRole):
    if role == Qt.DisplayRole:
        return index.column()  # 错误：返回了列序号

正确示例：

def data(self, index, role=Qt.DisplayRole):
    if not index.isValid():
        return None
    if role == Qt.DisplayRole:
        # 从自定义数据源中获取对应行列的数据
        item = self._data[index.row()]
        return item[index.column()]  # 假设item是存储多列数据的列表/对象

3. 确认模型与视图的关联 #

检查是否已将模型正确绑定到QTreeView：

model = YourCustomModel()
tree_view.setModel(model)

若未完成关联，视图会使用默认空模型，仅显示列号。

4. 动态数据更新需发送信号 #

如果是动态添加/修改数据到模型，必须调用对应信号通知视图更新：

• 添加数据时：调用beginInsertRows和endInsertRows包裹操作
• 修改数据时：发送dataChanged信号

未发送信号会导致视图无法感知数据变化，维持空状态或仅显示列号。

5. 表头设置（可选） #

若需要自定义表头文本，需实现headerData方法，否则表头会显示列序号，但不影响数据行展示：

def headerData(self, section, orientation, role=Qt.DisplayRole):
    if orientation == Qt.Horizontal and role == Qt.DisplayRole:
        return ["姓名", "年龄", "部门"][section]
    return super().headerData(section, orientation, role)

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