插入U盘时更新QFileSystemModel的问题及实现咨询

为什么设置setRootPath(QDir::rootPath())时U盘会显示？ #

Qt的QFileSystemModel在Windows平台有特殊实现细节：当你把根路径设为系统根目录（QDir::rootPath()，即C:\）时，模型不仅会监视该目录内的文件变更，还会额外监听系统逻辑驱动器的增减事件。这是因为Windows的系统根目录本身包含所有逻辑驱动器的入口节点，模型会自动枚举并跟踪这些驱动器的状态变化——包括U盘插入/移除这类设备级变更，所以视图会自动更新显示新插入的U盘。

文档描述的"仅监视newPath目录内的变更"是通用层面说明，未覆盖Windows平台特有的驱动器管理逻辑，这就是你感到困惑的原因。而当传入空字符串作为rootPath时，模型未完成初始化，不会启动任何文件系统监视器（包括驱动器变更监听），自然无法感知U盘插入。

如何实现无论setRootPath如何设置，U盘都能自动显示？ #

最简洁可靠的方案是让QFileSystemModel始终以系统根目录作为监视根路径，然后通过调整QTreeView的根索引控制视图默认显示的目录，而非修改模型的rootPath。这样模型会自动跟踪所有驱动器变化，同时视图可按需展示特定路径：

修改后的示例代码 #

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

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

    QFileSystemModel *model = new QFileSystemModel;
    // 固定模型监视系统根目录，确保捕获驱动器变更
    model->setRootPath(QDir::rootPath());
    model->setFilter(QDir::NoDotAndDotDot | QDir::AllDirs | QDir::NoSymLinks);

    QTreeView *treeView = new QTreeView;
    treeView->setModel(model);

    // 隐藏多余列，仅保留名称列
    for (int i = 1; i < model->columnCount(); ++i) {
        treeView->setColumnHidden(i, true);
    }

    // 可选：设置视图默认显示的目录（比如用户主目录）
    QString defaultDir = QDir::homePath();
    treeView->setRootIndex(model->index(defaultDir));

    treeView->setColumnWidth(0, 250);
    treeView->setWindowTitle("QFileSystemModel Example");
    treeView->resize(600, 400);
    treeView->setHeaderHidden(true);

    treeView->show();

    return app.exec();
}

关键说明 #

• 模型根路径固定为系统根：确保模型能监听所有驱动器的插入/移除事件，自动更新数据。
• 视图根索引按需设置：通过treeView->setRootIndex(model->index(目标路径))，可让视图默认展开到你需要的目录（比如用户主目录），但用户仍可向上导航到系统根节点，看到所有驱动器（包括新插入的U盘）。
• 自动更新机制：U盘插入时，模型会自动感知并添加对应的驱动器节点，视图会同步刷新显示。

特殊场景处理（必须自定义模型根路径） #

如果因业务需求必须将模型的rootPath设为非系统根目录，你需要手动监听系统驱动器变更事件：

• Windows平台：通过QNativeEventFilter监听WM_DEVICECHANGE消息，捕获U盘插入事件。
• 跨平台场景：定期调用QStorageInfo::mountedVolumes()获取当前驱动器列表，对比旧列表发现新增U盘，再通过model->index(U盘路径)获取索引，通知视图更新。

这种方式实现复杂，仅推荐在无法使用系统根作为模型根路径的特殊场景下使用。

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