如何在Qt中实现带复选框的文件系统树视图？

你已经选对了方向——继承QFileSystemModel确实是Qt生态中实现带复选框文件系统树视图的主流且可行的方案，能看出来你已经完成了核心功能的搭建。针对你提到的待完成工作和性能问题，我整理了具体的解决思路：

一、勾选/取消时设置等待光标或禁用树视图编辑 #

1. 等待光标实现 #

在处理复选状态变更的核心逻辑里（比如你重写的setData()方法，或者树视图的点击事件回调中），可以通过Qt的全局光标控制来提示用户当前操作正在进行：

bool CustomFileSystemModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (role == Qt::CheckStateRole) {
        // 开启等待光标
        QApplication::setOverrideCursor(Qt::WaitCursor);
        
        // 这里放置你处理当前项及子/父项复选状态的逻辑
        // 比如联动子节点勾选、更新父节点状态等
        
        // 操作完成后恢复原光标
        QApplication::restoreOverrideCursor();
        return true;
    }
    return QFileSystemModel::setData(index, value, role);
}

这种方式不会阻断用户的视觉反馈，体验比直接禁用视图更好。

2. 临时禁用树视图编辑 #

如果需要完全禁止操作期间的用户交互，可以在处理前调用树视图的setEnabled(false)，完成后再恢复：

// 假设treeView是你的QTreeView实例
treeView->setEnabled(false);
// 处理复选状态逻辑
treeView->setEnabled(true);

不过这种方式会让视图灰显，建议优先选择等待光标方案。

二、优化根节点勾选耗时问题 #

根节点包含大量子项，同步遍历处理必然导致UI卡顿，异步处理是解决这个问题的关键：
你可以借助QtConcurrent::run将子项状态遍历的逻辑放到后台线程执行，避免阻塞UI线程；待后台计算完成后，再切回UI线程更新模型数据（因为Qt模型视图框架要求模型操作必须在UI线程进行）。示例代码如下：

void CustomFileSystemModel::toggleRootCheck(const QModelIndex &rootIndex, bool checked)
{
    QApplication::setOverrideCursor(Qt::WaitCursor);
    
    // 后台线程遍历所有子节点，收集需要更新的索引
    QtConcurrent::run([this, rootIndex, checked]() {
        QList<QPersistentModelIndex> childIndexes;
        // 递归遍历根节点下的所有子项，将有效索引存入列表
        collectAllChildIndexes(rootIndex, childIndexes);
        
        // 切回UI线程更新模型状态
        QMetaObject::invokeMethod(this, [this, childIndexes, checked]() {
            foreach (const QPersistentModelIndex &idx, childIndexes) {
                if (idx.isValid()) {
                    setData(idx, checked ? Qt::Checked : Qt::Unchecked, Qt::CheckStateRole);
                }
            }
            QApplication::restoreOverrideCursor();
        }, Qt::QueuedConnection);
    });
}

// 辅助函数：递归收集所有子节点索引
void CustomFileSystemModel::collectAllChildIndexes(const QModelIndex &parent, QList<QPersistentModelIndex> &indexes)
{
    for (int row = 0; row < rowCount(parent); ++row) {
        QModelIndex child = index(row, 0, parent);
        indexes.append(QPersistentModelIndex(child));
        if (hasChildren(child)) {
            collectAllChildIndexes(child, indexes);
        }
    }
}

另外，你还可以考虑增量加载的思路：比如先更新当前可见节点的状态，用户滚动到未处理的节点时再异步更新其状态，不过这种方式需要更复杂的状态管理逻辑，适合对性能要求极高的场景。

额外提示 #

别忘了维护好复选状态的父子联动逻辑——比如父节点勾选时自动选中所有子节点，子节点部分选中时将父节点设为Qt::PartiallyChecked状态，这是带复选框树视图的核心体验点。

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