Qt/Qml程序中FolderListModel访问共享文件夹失败问题

这个问题我之前也碰到过，核心原因是本地文件URI格式在网络共享场景下不兼容，加上application.dirPath()返回的路径在共享环境下需要特殊处理。

问题分析 #

你当前的代码里直接拼接file:///和application.dirPath()：

FolderListModel { 
    id: progModel 
    folder: "file:///" + application.dirPath() 
    Component.onCompleted: console.log("folder: " + folder) 
}

在本地运行时，application.dirPath()返回的是类似C:\xxx\yyy的本地路径，拼接后变成file:///C:/xxx/yyy，这符合本地文件URI规范，所以能正常工作。

但当程序从Windows共享文件夹（比如\\server\appshare）运行时，application.dirPath()返回的是UNC格式的路径，你直接加file:///会变成file:///\\server\appshare，这不符合网络共享的URI规范——Windows共享的正确file URI格式应该是file:////server/appshare（四个斜杠开头，把UNC的反斜杠换成正斜杠）。

解决方案 #

1. Qml内动态处理路径转换

在Qml里添加一个辅助函数，自动识别路径类型并生成正确的file URI：

function getValidFolderUri(localPath) {
    // 处理UNC共享路径（\\server\share 格式）
    if (localPath.startsWith("\\")) {
        // 替换反斜杠为正斜杠，前缀替换为四个斜杠的网络文件URI格式
        return "file:///" + localPath.replace(/\\/g, "/");
    } else {
        // 本地路径沿用原有逻辑
        return "file:///" + localPath;
    }
}

FolderListModel { 
    id: progModel 
    folder: getValidFolderUri(application.dirPath()) 
    Component.onCompleted: console.log("folder: " + folder) 
}

这样不管是本地路径还是共享UNC路径，都能生成符合规范的URI。

2. 借助C++后端的Qt API（更可靠）

如果你的项目有C++后端，推荐用Qt原生API处理路径转换，它会自动适配不同平台的路径规则：

// C++代码示例
#include <QUrl>
#include <QGuiApplication>

// 将该函数注册为Qml可调用方法
Q_INVOKABLE QUrl getAppFolderUri() {
    return QUrl::fromLocalFile(QGuiApplication::applicationDirPath());
}

然后在Qml中调用这个函数：

FolderListModel { 
    id: progModel 
    folder: getAppFolderUri().toString() 
    Component.onCompleted: console.log("folder: " + folder) 
}

这种方式能避免手动处理路径格式的各种边缘情况，稳定性更高。

3. 检查共享权限

最后别忘了确认：

• 运行程序的Windows用户对目标共享文件夹拥有读取权限
• 共享文件夹的系统权限设置中，已允许该用户访问并读取文件

验证方法 #

可以在Component.onCompleted里打印最终生成的folder值，确认格式是否正确：

• 本地路径应为：file:///C:/xxx/yyy
• 共享路径应为：file:////server/appshare

如果路径格式正确，FolderListModel就能正常列出共享文件夹里的qml文件了。

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