QTreeView调用QFileSystemModel出现额外调用的问题排查与优化

问题描述 #

在Windows 11系统下使用Qt 6.6.2，通过继承QFileSystemModel子类追踪sort()和data()方法的调用情况，搭配QTreeView使用时遇到以下问题：

• 设置根目录后，sort()被调用3次而非预期的1次；
• 目标目录仅含3个文件，但data()被调用了360次；
• 移动鼠标或调整窗口大小时，data()会再次触发调用。

期望实现：sort()仅在用户主动选择排序时调用一次，data()仅在文件夹内容变化等真实需要更新的场景下调用。

测试代码如下：

#include <QApplication>
#include <QTreeView>
#include <QFileSystemModel>

class Model : public QFileSystemModel
{
public:

    void sort(int column, Qt::SortOrder order = Qt::AscendingOrder) override
    {
        static int i = 0;
        qDebug() << "sort() " << ++i;
        QFileSystemModel::sort(column, order);
    }

    QVariant data(const QModelIndex& index,int role) const override
    {
        static int i = 0;
        qDebug() << "data() " << ++i;
        return QFileSystemModel::data(index, role);
    }
};


int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    Model *model = new Model;
    model->setRootPath(QDir::rootPath());
    QTreeView *treeView = new QTreeView;

    treeView->setModel(model);
    treeView->setColumnWidth(0, 250);
    treeView->setWindowTitle("QFileSystemModel Example");
    treeView->resize(600, 400);
    treeView->setRootIndex(model->index("C:\\Users\\Username\\Desktop\\qt"));

    treeView->show();
    treeView->setSortingEnabled(true);

    return app.exec();
}

原因分析 #

1. sort()多次调用的原因 #

• 初始化阶段的默认触发：setSortingEnabled(true)会自动触发一次排序；QFileSystemModel绑定视图时，视图会请求初始排序状态，再加上切换根目录后视图需要适配新数据的排序校验，三者叠加导致多次调用。
• Qt内部状态同步：视图与模型间的状态同步逻辑，会在根目录切换、模型数据更新等场景下触发排序确认，产生额外调用。

2. data()频繁调用的原因 #

• 多角色数据请求：data()会被请求多种角色的数据，比如Qt::DisplayRole（显示文本）、Qt::DecorationRole（图标）、Qt::ToolTipRole（提示）、Qt::SizeHintRole（尺寸）等。每个文件对应多列，每列对应多角色，累加后调用次数远超文件数量。
• 视图重绘触发：移动鼠标时，视图需要更新悬停项的样式（Qt::HoverRole）；调整窗口大小时，视图会重新布局并请求所有可见项的显示数据与尺寸，触发data()重复调用。
• 异步加载特性：QFileSystemModel是异步加载文件数据的，加载过程中会多次通知视图更新，每次更新都会触发数据请求。

优化方案 #

1. 减少sort()不必要调用 #

• 调整初始化顺序：将setSortingEnabled(true)移到setRootIndex之前，手动设置初始排序规则，避免根目录切换后重复触发排序：

  treeView->setSortingEnabled(true);
  treeView->sortByColumn(0, Qt::AscendingOrder); // 手动指定初始排序
  treeView->setRootIndex(model->index("C:\\Users\\Username\\Desktop\\qt"));
  treeView->show();
  

• 添加状态判断：重写sort()时，检查当前排序状态与请求是否一致，一致则直接返回：

  void sort(int column, Qt::SortOrder order = Qt::AscendingOrder) override
  {
      static int i = 0;
      if (column == sortColumn() && order == sortOrder()) {
          return;
      }
      qDebug() << "sort() " << ++i;
      QFileSystemModel::sort(column, order);
  }
  

2. 减少data()不必要调用 #

• 按需处理角色：仅在需要自定义的角色中添加追踪逻辑，其他角色直接调用父类方法，避免无意义的日志输出与逻辑执行：

  QVariant data(const QModelIndex& index,int role) const override
  {
      // 仅追踪需要关注的角色，比如DisplayRole
      if (role == Qt::DisplayRole) {
          static int i = 0;
          qDebug() << "data() DisplayRole " << ++i;
      }
      return QFileSystemModel::data(index, role);
  }
  

• 禁用不必要的视图特性：关闭鼠标追踪减少悬停触发的调用，或者禁用不需要的工具提示：

  treeView->setMouseTracking(false); // 关闭鼠标追踪
  

• 批量操作时关闭更新：在初始化等批量操作阶段，临时关闭视图更新，完成后再开启：

  treeView->setUpdatesEnabled(false);
  // 执行批量设置操作
  treeView->setUpdatesEnabled(true);
  

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