Qt实战：用QStandardItemModel递归遍历QTreeView所有节点（附完整代码示例）

Qt树形控件深度探索：QStandardItemModel递归遍历与实战技巧

1. 理解Qt模型/视图架构中的树形结构

Qt的模型/视图架构是其GUI编程的核心设计之一，它将数据管理与用户界面展示分离，提供了极高的灵活性和可扩展性。在这个架构中，QTreeView作为展示树形数据的视图组件，而QStandardItemModel则是最常用的标准模型实现。

树形结构在软件开发中无处不在：文件系统目录、组织结构图、XML/JSON数据解析、分类管理系统等场景都需要树形展示。与线性结构不同，树形数据具有以下特点：

• 层级关系：节点之间存在父子关系
• 递归特性：每个子树本身也是一棵树
• 动态扩展：节点可以展开/折叠显示

QStandardItemModel作为Qt提供的通用模型，内部使用QStandardItem来存储数据项，自动维护了父子关系链。这种设计使得开发者无需手动管理节点间的连接关系，只需关注业务数据本身。

模型/视图架构的核心优势：

• 数据与显示分离，同一模型可被多个视图共享
• 自动同步机制，模型数据变化即时反映到视图
• 标准化接口，便于自定义模型和委托

2. 构建树形模型基础环境

2.1 创建基本树形结构

首先我们需要设置基本的Qt项目环境并创建树形视图：

#include <QApplication>
#include <QTreeView>
#include <QStandardItemModel>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    
    // 创建树形视图和标准模型
    QTreeView treeView;
    QStandardItemModel model;
    
    // 设置模型表头
    model.setHorizontalHeaderLabels({"名称", "类型", "大小"});
    
    // 构建根节点
    QStandardItem *rootItem = model.invisibleRootItem();
    
    // 添加一级节点
    QStandardItem *folder1 = new QStandardItem("项目文档");
    QStandardItem *folder2 = new QStandardItem("设计资源");
    rootItem->appendRow(folder1);
    rootItem->appendRow(folder2);
    
    // 添加二级节点
    QStandardItem *doc1 = new QStandardItem("需求文档.doc");
    QStandardItem *doc2 = new QStandardItem("设计文档.pdf");
    folder1->appendRow({doc1, new QStandardItem("Word文档"), new QStandardItem("2.5MB")});
    folder1->appendRow({doc2, new QStandardItem("PDF文档"), new QStandardItem("3.1MB")});
    
    // 设置模型并显示
    treeView.setModel(&model);
    treeView.expandAll();  // 默认展开所有节点
    treeView.show();
    
    return app.exec();
}

2.2 模型数据角色与扩展属性

QStandardItem不仅存储显示文本(Qt::DisplayRole)，还支持多种数据角色：

设置多角色数据的示例：

QStandardItem *item = new QStandardItem();
item->setData("项目计划.pdf", Qt::DisplayRole);
item->setData(QIcon(":/icons/pdf.png"), Qt::DecorationRole);
item->setData("最后修改: 2023-05-15", Qt::ToolTipRole);
item->setData(1001, Qt::UserRole);  // 存储文件ID

3. 递归遍历算法深度解析

3.1 深度优先遍历实现

递归是处理树形结构的自然方式，以下是深度优先遍历的标准实现：

void traverseTree(QStandardItem *item, int indent = 0) {
    if (!item) return;
    
    // 打印当前节点信息（带缩进）