Windows下QDirIterator遍历桌面目录卡顿问题求助

问题场景 #

在Windows 10系统中，使用Qt 5.14.2（搭配自带mingw32编译器g++ 7.3.0）的QDirIterator遍历用户桌面目录时，程序出现锁定卡顿，始终无法输出complete。即使移除目录中后续文件，卡顿点会自动前移，无法完成遍历。同时调用QDir.entryInfoList()也会导致GUI无响应，该程序在其他设备运行正常。用户执行dir/a %USERPROFILE%\desktop命令可正常列出所有文件，目录列表无明显可见异常。

排查与解决方法 #

1. 过滤特殊文件/文件夹 #

优先排查桌面目录中的特殊文件，这类文件是Qt遍历组件最容易卡住的诱因：

• 快捷方式(.lnk)与网络共享文件夹：Qt解析指向无效路径或未挂载网络位置的快捷方式时，可能陷入超时等待。修改代码，遍历到文件时先判断类型并跳过：

while(qdi.hasNext())
{
    QString name = qdi.next();
    QFileInfo fileInfo(qdi.filePath());
    // 跳过快捷方式和网络目录
    if (fileInfo.isSymLink() || (fileInfo.isDir() && fileInfo.isNetworkFileSystem())) {
        tsout << "Skipping: " << name << endl;
        tsout << flush;
        continue;
    }
    tsout << "name = " << name << endl;
    tsout << flush;
}

• 系统/隐藏异常文件：如损坏的desktop.ini、回收站关联文件等，可创建QDirIterator时指定过滤规则，先跳过系统文件：

QDirIterator qdi(user_desktop_dir, QDir::NoDotAndDotDot | QDir::Files | QDir::Dirs, QDirIterator::SkipSymlinks);

2. 增加超时与有效性校验 #

给遍历过程增加超时检测，同时校验文件有效性，避免卡在无效文件上：

#include <QElapsedTimer>

while(qdi.hasNext())
{
    QString name = qdi.next();
    QFileInfo fi(name);
    // 跳过不存在的无效文件
    if (!fi.exists()) {
        tsout << "Invalid file: " << name << endl;
        tsout << flush;
        continue;
    }
    // 5秒超时强制退出当前遍历节点
    static QElapsedTimer timer;
    if (!timer.isValid()) timer.start();
    if (timer.elapsed() > 5000) {
        tsout << "Timeout at: " << name << endl;
        tsout << flush;
        timer.restart();
        continue;
    }
    tsout << "name = " << name << endl;
    tsout << flush;
}

3. 改用Windows原生API遍历 #

如果Qt的文件遍历组件存在兼容性问题，直接调用Windows原生API绕过Qt封装层：

#include <windows.h>

void fubarDesktopNative()
{
    WCHAR desktopPath[MAX_PATH];
    wcscpy_s(desktopPath, qgetenv("USERPROFILE").toStdWString().c_str());
    wcscat_s(desktopPath, L"\\Desktop\\*");

    WIN32_FIND_DATAW findData;
    HANDLE hFind = FindFirstFileW(desktopPath, &findData);
    if (hFind == INVALID_HANDLE_VALUE) return;

    do {
        if (wcscmp(findData.cFileName, L".") == 0 || wcscmp(findData.cFileName, L"..") == 0)
            continue;
        tsout << "name = " << QString::fromWCharArray(findData.cFileName) << endl;
        tsout << flush;
    } while (FindNextFileW(hFind, &findData));

    FindClose(hFind);
    tsout << "complete" << endl;
    tsout << flush;
}

4. 升级Qt版本或系统补丁 #

Qt 5.14.2存在部分Windows文件系统相关的已知bug，建议升级到Qt 5.15.x LTS版本；同时检查Windows 10是否安装最新累积更新，部分系统补丁可修复文件系统API的兼容性问题。

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