QTreeView中QStandardItem如何实现带布局的自定义项渲染

你之前的写法从根上就错了：QStandardItem是模型层的数据存储对象，QWidget是渲染层的窗口控件，二者生命周期、底层逻辑完全不兼容，禁止多重继承这两个类。
QStandardItem本身没有任何窗口上下文，也不走Qt的控件渲染管线，你给它调用setLayout相当于给一个没有底层句柄的空对象强行挂载控件树，渲染时触发空指针崩溃是必然结果。

你需要实现的效果如下：

Qt的模型/视图架构本身就不允许在Item对象里直接塞控件，要实现带自定义布局的树项，有两种官方支持的成熟方案，都不需要手动维护嵌套Widget模拟层级，完全复用QTreeView原生的折叠、选中、层级管理能力：

• 方案1：使用setIndexWidget绑定自定义控件，实现成本最低，适合项数量在几百以内的场景
• 方案2：自定义QStyledItemDelegate委托绘制，性能最高，适合项数量上千的大数据量场景

方案1：快速实现（setIndexWidget） #

这个方案完全保留你现有的QStandardItem数据存储逻辑，只需要把渲染用的控件单独抽离成独立的QWidget子类，再绑定到对应树节点的索引上即可。
首先单独实现自定义项控件，不要和QStandardItem混写：

class ModPackItemWidget(qtw.QWidget):
    def __init__(self, name:str, desc:str, tags:list[str], cover_path:str, parent=None):
        super().__init__(parent)
        h_layout = qtw.QHBoxLayout(self)
        h_layout.setContentsMargins(6, 6, 6, 6)
        h_layout.setSpacing(8)

        # 加载封面图标
        cover_label = qtw.QLabel()
        cover = qtg.QPixmap(cover_path).scaled(
            64, 64, 
            qtc.Qt.KeepAspectRatioByExpanding, 
            qtc.Qt.SmoothTransformation
        )
        cover_label.setPixmap(cover)
        h_layout.addWidget(cover_label)

        # 右侧文字区域：标题、描述、标签
        text_layout = qtw.QVBoxLayout()
        text_layout.setSpacing(4)
        # 标题（加粗）
        name_label = qtw.QLabel(f"<b>{name}</b>")
        name_label.setFont(qtg.QFont('Calibri', 12))
        # 描述（灰色小字）
        desc_label = qtw.QLabel(desc)
        desc_label.setStyleSheet("color: #666; font-size: 12px;")
        # 标签（蓝色小字）
        tag_label = qtw.QLabel(" ".join([f"#{t}" for t in tags]))
        tag_label.setStyleSheet("color: #2563eb; font-size: 11px;")

        text_layout.addWidget(name_label)
        text_layout.addWidget(desc_label)
        text_layout.addWidget(tag_label)
        text_layout.addStretch()
        h_layout.addLayout(text_layout)
        h_layout.addStretch()

添加树节点时，把描述、标签这类自定义数据存在QStandardItem的自定义角色里，之后绑定控件即可：

# 原有添加节点逻辑不变，额外存储自定义数据
modPack = qtg.QStandardItem('Dont Starve Together')
modPack.setEditable(False)
# 自定义Role存储额外数据
modPack.setData("支持联机的生存类游戏Mod整合包", qtc.Qt.UserRole + 1)
modPack.setData(["生存", "联机", "官方中文"], qtc.Qt.UserRole + 2)
testMod = qtg.QStandardItem("TestMod")
modPack.appendRow(testMod)
self.rootNode.appendRow(modPack)

# 给节点绑定自定义渲染控件
index = modPack.index()
item_widget = ModPackItemWidget(
    name=modPack.text(),
    desc=modPack.data(qtc.Qt.UserRole + 1),
    tags=modPack.data(qtc.Qt.UserRole + 2),
    cover_path="./assets/defaultModPack.jpg"
)
self.window.tView_modPacks.setIndexWidget(index, item_widget)

这个方案几十行代码就能实现你截图里的效果，项里需要加按钮、输入框这类交互控件也可以直接在自定义Widget里写信号槽，开发效率最高。

方案2：高性能实现（自定义委托） #

如果你的Mod/Mod包总数可能达到上千量级，setIndexWidget因为会创建大量实体控件会出现卡顿，这时候用自定义委托绘制是最优解。
核心逻辑：

1. 所有标题、描述、标签、图标数据全部存在QStandardItem的自定义Role中，和方案1的数据存储逻辑一致
2. 继承QStyledItemDelegate重写paint方法，在项的绘制区域内按照你需要的布局规则，手动绘制图标、各段文字，效果和布局排版完全和QWidget一致
3. 重写sizeHint方法，根据内容长度返回每个项的合适高度
4. 调用QTreeView.setItemDelegate()把自定义委托设置给树控件即可
   这个方案是所有桌面端类启动器应用（包括你提到的Technic启动器、Steam游戏列表）实现自定义列表项的标准方案，渲染性能比挂载实体QWidget高一个量级，因为所有项都是用画笔直接绘制，不需要维护控件树。

• 绝对不要尝试多重继承QStandardItem和任何QWidget子类，二者分属Qt框架的数据层和渲染层，没有兼容设计
• 不需要手动写嵌套QWidget模拟树层级，上述两种方案都完美支持QTreeView原生的折叠展开、选中高亮、右键菜单等所有内置功能
• 如果项内有复杂交互（比如按钮点击、输入框编辑）优先选方案1，实现成本最低；如果只是静态展示内容、数据量大，选方案2。

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