PySide2/6 QColumnView懒加载UI不更新问题求助（QTreeView正常）

问题描述 #

开发实体层级结构展示应用，因数据库无法全量获取，实现懒加载机制：仅在用户展开父项时查询对应实体。使用QColumnView时，点击实体后控制台显示数据已加载，但UI需切换其他项再返回才刷新；替换为QTreeView则功能正常。PySide2与PySide6均存在此问题，尝试多种信号通知UI无效。

核心原因 #

1. 模型修改时机不当：在data()方法中直接修改模型结构（移除占位符、添加子项）时，视图正处于数据请求流程中，模型自动发出的变更信号可能被QColumnView忽略，导致视图状态不同步。
2. QColumnView架构特性：QColumnView由多列独立的QListView组成，相比QTreeView，它对模型结构变更的响应需要更明确的信号触发，否则当前列视图不会主动刷新。

解决方案 #

1. 规范模型修改流程：手动发出beginRemoveRows/endRemoveRows、beginInsertRows/endInsertRows信号，确保视图能正确捕捉模型的结构变化。
2. 主动刷新列视图：加载完成后，触发QColumnView对应列的视图刷新，强制更新UI。
3. 优化加载触发逻辑：保留原有占位符触发方式，但确保模型修改时的信号通知规范。

修改后的代码 #

#!/usr/bin/env python
# coding=utf-8

import logging
import time
from dataclasses import dataclass
from typing import Union, Any, List

from PySide2.QtCore import QModelIndex, Qt, Signal
from PySide2.QtGui import QStandardItemModel, QStandardItem
from PySide2.QtWidgets import QColumnView, QApplication


class DatabaseConnector:
    """模拟数据库查询"""

    def get_root_data(self) -> List[dict]:
        time.sleep(1)  # 模拟网络请求耗时
        return [
            {"id": "1", "type": "Project", "name": "Some project1"},
            {"id": "2", "type": "Project", "name": "Some project2"},
            {"id": "3", "type": "Project", "name": "Some project3"},
        ]

    def expand(self, f_id: str, f_type: str) -> List[dict]:
        time.sleep(1)  # 模拟网络请求耗时
        return self.get_root_data()


@dataclass
class Entity:
    id: str
    type: str


class BaseModel(QStandardItemModel):
    # 加载完成信号，用于通知视图刷新
    loaded = Signal(QModelIndex)

    def __init__(self) -> None:
        super().__init__()
        self.data_provider = DatabaseConnector()
        root_data = self.data_provider.get_root_data()
        for data in root_data:
            project_item = self._create_child(data)
            self.invisibleRootItem().appendRow(project_item)

    def _create_child(self, data) -> QStandardItem:
        """创建带占位符的子项"""
        entity = Entity(data['id'], data['type'])
        child_item = QStandardItem(data['name'])
        child_item.setData(entity, Qt.ItemDataRole.UserRole)

        # 添加占位符，标记该项目未加载
        loading_child = QStandardItem("Loading...")
        child_item.appendRow(loading_child)

        return child_item

    def data(self, index: Union[QModelIndex, QPersistentModelIndex],
             role: int = ...) -> Any:
        data = super().data(index, role)
        # 触发加载逻辑：当请求占位符的显示文本时，加载父项的子数据
        if role == Qt.ItemDataRole.DisplayRole and data == "Loading...":
            parent_index = index.parent()
            if parent_index.isValid():
                logging.warning("开始加载子项")
                self._fill_parent(parent_index)
        return data

    def _fill_parent(self, parent: QModelIndex) -> None:
        """加载并填充父项的子数据"""
        parent_item = self.itemFromIndex(parent)
        entity: Entity = parent_item.data(Qt.ItemDataRole.UserRole)

        # 1. 移除占位符：手动发出移除信号
        if parent_item.rowCount() > 0:
            self.beginRemoveRows(parent, 0, 0)
            parent_item.removeRow(0)
            self.endRemoveRows()

        # 2. 请求数据
        children_data = self.data_provider.expand(entity.id, entity.type)
        print("获取到数据", children_data)

        # 3. 添加子项：手动发出插入信号
        if children_data:
            self.beginInsertRows(parent, 0, len(children_data)-1)
            for child in children_data:
                print(f"添加子项: {child['name']}")
                child_item = self._create_child(child)
                parent_item.appendRow(child_item)
            self.endInsertRows()

        # 4. 发出加载完成信号，通知视图刷新
        self.loaded.emit(parent)


if __name__ == '__main__':
    app = QApplication()
    model = BaseModel()
    entity_selector = QColumnView()
    entity_selector.setModel(model)
    entity_selector.resize(800, 200)

    # 连接加载完成信号，刷新对应列的视图
    def on_model_loaded(index):
        # 获取当前选中项所在的列，子项在右侧列
        current_col = entity_selector.currentIndex().column()
        view = entity_selector.view(current_col + 1)
        if view:
            view.reset()

    model.loaded.connect(on_model_loaded)

    entity_selector.show()
    app.exec_()

关键修改点说明 #

• 添加loaded信号，用于在数据加载完成后通知视图刷新。
• 在_fill_parent方法中，手动调用模型变更信号，确保视图能捕捉到结构变化。
• 实现on_model_loaded回调，刷新子项所在的列视图，强制UI即时更新。

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