QTreeView含QImage的项拖放致程序冻结的解决方法

我之前也碰到过一模一样的情况——QTreeView里的项带QImage时拖放就卡成狗，注释掉QImage赋值就正常。本质问题是拖放过程中默认会对整个项对象做序列化操作，大尺寸/高像素的QImage序列化/反序列化会直接阻塞UI主线程，导致程序冻结。下面给你几个实用的解决思路，既能保留渲染好的QImage，又能让拖放流畅运行：

核心思路：避免拖放时传递完整QImage #

拖放不需要把整个QImage对象传来传去，只需要传递能定位到这个项的标识，或者传递压缩后的图像数据就行，分三种方案给你参考：

方案1：只传递项的唯一标识（最推荐） #

这是效率最高的方式，拖放时只传项的索引、ID这类轻量数据，接收端再从原数据源里取QImage：

class CustomTreeModel(QAbstractItemModel):
    # 假设你的项存在self.items列表中
    def __init__(self, parent=None):
        super().__init__(parent)
        self.items = []

    # 重写mimeData，只传递项的行号（或你的自定义唯一ID）
    def mimeData(self, indexes):
        mime_data = QMimeData()
        # 收集有效索引对应的行号
        selected_ids = [str(index.row()) for index in indexes if index.isValid()]
        # 自定义MIME类型，避免和系统格式冲突
        mime_data.setData("application/tree-item-ids", QByteArray(",".join(selected_ids).encode()))
        return mime_data

    # 重写dropMimeData，根据标识获取对应项和QImage
    def dropMimeData(self, data, action, row, column, parent):
        if action == Qt.IgnoreAction:
            return True
        if data.hasFormat("application/tree-item-ids"):
            # 解析传递的行号
            id_bytes = data.data("application/tree-item-ids")
            selected_rows = [int(idx) for idx in id_bytes.data().decode().split(",")]
            # 根据行号从原数据源获取项和QImage
            for row_idx in selected_rows:
                target_item = self.items[row_idx]
                # 这里就能正常使用target_item._Image了
                # ... 处理你的拖放逻辑（比如插入、移动项） ...
            return True
        return super().dropMimeData(data, action, row, column, parent)

方案2：传递压缩后的QImage字节 #

如果必须要在拖放时传递图像数据，可以先把QImage压缩成字节流，减少数据量：

# 先给你的项类加个压缩图像的方法
class TreeItem:
    def __init__(self):
        self._Image = QImage()
        self._compressed_image = QByteArray()

    def update_compressed_image(self):
        # 把QImage压缩成PNG字节（保留透明度，用JPG会更省空间但丢透明）
        buffer = QBuffer(self._compressed_image)
        buffer.open(QIODevice.WriteOnly)
        self._Image.save(buffer, "PNG", quality=80)  # quality可调整压缩率

# 拖放时传递压缩后的字节
def mimeData(self, indexes):
    mime_data = QMimeData()
    for index in indexes:
        if index.isValid():
            item = self.itemFromIndex(index)
            item.update_compressed_image()
            mime_data.setData("application/compressed-image", item._compressed_image)
    return mime_data

# 接收端解码还原QImage
def dropMimeData(self, data, action, row, column, parent):
    if data.hasFormat("application/compressed-image"):
        byte_data = data.data("application/compressed-image")
        restored_image = QImage()
        restored_image.loadFromData(byte_data)
        # 用restored_image创建新项或更新现有项
        return True
    return super().dropMimeData(data, action, row, column, parent)

方案3：异步序列化（不推荐，复杂度高） #

如果硬要传递完整QImage，可以把序列化操作放到后台线程，但需要处理线程安全问题，代码复杂度会高很多，除非特殊需求不建议用这种方式。

内容的提问来源于stack exchange，提问作者Philipp Drieß