带异表头子项的嵌套QStandardItemModel最佳实践咨询

刚好之前处理过类似的场景，结合你提到的情况——TreeViewA的顶级项数量不多（≤10）、子项要在TreeViewB展示且两者表头完全不同，给你分享经过验证的最佳实践，最推荐的是拆分Model+选中同步的思路，简单高效还不容易踩坑：

核心思路 #

因为两个视图的表头结构完全独立，直接共用一个QStandardItemModel会导致表头适配的麻烦（比如TreeViewA只需要顶级项的列，TreeViewB需要子项的列）。而由于TreeViewA的顶级项数量很少，每次选中时同步子项数据的性能开销几乎可以忽略，所以拆分Model是最直观的方案：

• 用一个独立的QStandardItemModel给TreeViewA，专门存储顶级项数据
• 用另一个独立的QStandardItemModel给TreeViewB，专门存储当前选中顶级项的子项数据
• 通过TreeViewA的选中信号，触发子项数据从原嵌套结构同步到TreeViewB的Model中

具体实现步骤 #

1. 初始化两个视图的Model #

先分别为TreeViewA和TreeViewB创建Model，设置各自独立的表头：

// TreeViewA的顶级项Model
QStandardItemModel* topLevelModel = new QStandardItemModel(this);
topLevelModel->setHorizontalHeaderLabels({"顶级项名称", "分类标签"});
ui->treeViewA->setModel(topLevelModel);

// TreeViewB的子项Model
QStandardItemModel* childItemModel = new QStandardItemModel(this);
childItemModel->setHorizontalHeaderLabels({"子项ID", "数值", "更新时间"});
ui->treeViewB->setModel(childItemModel);

2. 填充嵌套数据到顶级Model #

在顶级Model中添加顶级项，同时为每个顶级项挂载对应的子项数据（可以用Qt::UserRole存储子项需要的额外字段，避免和顶级项的列冲突）：

// 示例：添加5个顶级项
for (int i = 0; i < 5; ++i) {
    QStandardItem* topItem = new QStandardItem(QString("项目%1").arg(i+1));
    topItem->setData("核心业务类", Qt::UserRole+1); // 顶级项的额外描述

    // 为当前顶级项添加子项
    for (int j = 0; j < 20; ++j) {
        QStandardItem* childItem = new QStandardItem(QString("子项%1-%2").arg(i+1).arg(j+1));
        // 存储TreeViewB需要的字段
        childItem->setData(1000 + i*100 + j, Qt::UserRole+2); // 子项ID
        childItem->setData(rand() % 500, Qt::UserRole+3); // 数值
        childItem->setData(QDateTime::currentDateTime().addSecs(-j*3600), Qt::UserRole+4); // 更新时间
        topItem->appendRow(childItem);
    }

    topLevelModel->appendRow(topItem);
}

3. 绑定选中事件同步子项数据 #

监听TreeViewA的选择变化，当选中某个顶级项时，将其下的子项数据同步到TreeViewB的Model中：

connect(ui->treeViewA->selectionModel(), &QItemSelectionModel::selectionChanged, 
        this, [=](const QItemSelection& selected, const QItemSelection& deselected){
    // 清空TreeViewB的旧数据
    childItemModel->clear();
    childItemModel->setHorizontalHeaderLabels({"子项ID", "数值", "更新时间"});

    if (selected.isEmpty()) return;

    // 获取选中的顶级项
    QModelIndex selectedIndex = selected.indexes().first();
    QStandardItem* selectedTopItem = topLevelModel->itemFromIndex(selectedIndex);
    if (!selectedTopItem) return;

    // 遍历顶级项的子项，填充到TreeViewB的Model
    for (int row = 0; row < selectedTopItem->rowCount(); ++row) {
        QStandardItem* childItem = selectedTopItem->child(row);
        if (!childItem) continue;

        QList<QStandardItem*> rowItems;
        rowItems.append(new QStandardItem(childItem->text()));
        rowItems.append(new QStandardItem(QString::number(childItem->data(Qt::UserRole+3).toInt())));
        rowItems.append(new QStandardItem(childItem->data(Qt::UserRole+4).toDateTime().toString("yyyy-MM-dd hh:mm")));
        
        childItemModel->appendRow(rowItems);
    }
});

4. 维护数据一致性（可选） #

如果子项数据可能动态更新，监听顶级Model的dataChanged信号，当当前选中项的子项数据变化时，自动刷新TreeViewB：

connect(topLevelModel, &QStandardItemModel::dataChanged, 
        this, [=](const QModelIndex& topLeft, const QModelIndex& bottomRight, const QVector<int>& roles){
    // 检查变化的项是否属于当前选中的顶级项
    QModelIndex currentSelected = ui->treeViewA->selectionModel()->currentIndex();
    if (!currentSelected.isValid()) return;

    QModelIndex changedItemParent = topLeft.parent();
    if (changedItemParent == currentSelected) {
        // 重新加载当前选中项的子项数据
        // 可以把之前的同步逻辑封装成函数，这里直接调用
        refreshChildModel(currentSelected);
    }
});

为什么推荐这个方案？ #

• 简单直观：代码逻辑清晰，不用复杂的ProxyModel或自定义Model，新手也能快速上手
• 表头完全独立：两个视图的表头各自设置，完全不用考虑列冲突或适配问题
• 性能无忧：因为顶级项≤10，就算每个顶级项有上千个子项，同步数据的开销也极小，不会影响UI流畅度
• 易维护：数据同步逻辑集中，后续修改表头或数据结构时，只需要调整对应的部分即可

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