Python中基于QAbstractItemModel给QTreeView项添加图标失败

你的问题核心在于自定义的QAbstractItemModel子类没有在data()方法中处理Qt.DecorationRole角色，这是QTreeView获取项图标的关键逻辑，另外你的set_icon方法和调用代码也有几个小问题，具体修正如下：

1. 修正set_icon方法 #

首先，不要用self.icon这种单变量存图标（会覆盖之前的设置），应该用字典存储不同列的图标，同时要通知视图数据更新：

def __init__(self):
    # 初始化时新增字典，用于存储各列对应的图标
    self.column_icons = {}
    # 你的其他初始化代码...

def set_icon(self, column: int, icon: QIcon):
    if 0 <= column < len(self.item_data):
        self.column_icons[column] = icon
        # 必须发送数据变化信号，触发视图刷新
        self.dataChanged.emit(self.index(), self.index(), [Qt.DecorationRole])
        return True
    return False

2. 在data()方法中处理图标角色 #

QTreeView会通过data()方法的Qt.DecorationRole获取图标，所以要在该方法中添加对应逻辑：

def data(self, index, role=Qt.DisplayRole):
    if not index.isValid():
        return None
    
    column = index.column()
    if role == Qt.DisplayRole:
        # 你的原有文本显示逻辑，比如返回self.item_data[column]
        return self.item_data[column]
    elif role == Qt.DecorationRole:
        # 返回对应列的图标，没有则返回None
        return self.column_icons.get(column, None)
    # 其他角色的处理逻辑（比如对齐、字体等）...

3. 修正图标调用代码 #

你调用时错误地把QIcon转成了Pixmap，而且资源路径写法冲突（:/是qrc资源前缀，不能和本地路径混用），直接传QIcon即可：

# 本地路径写法（直接用绝对路径，不要加:/）
child.set_icon(1, QIcon("C:/Users/E40055301/Desktop/Icones/mail.svg"))

# 如果是用Qt资源文件（.qrc），路径应该是类似这样（假设qrc里的路径是Icons/mail.svg）
# child.set_icon(1, QIcon(":/Icons/mail.svg"))

做完以上三步，图标就能正常显示了。

内容的提问来源于stack exchange，提问作者Thomas.C