Qml 中的那些坑(八)---openUrlExternally 在 Linux 和 Windows 平台的不一致行为

【写在前面】

在使用 Qml 的 openUrlExternally() 函数时，开发者可能会遇到在 Linux 和 Windows 平台之间行为不一致的问题，尤其是在处理文件 URL 时。

本文将深入探讨这一问题的成因及解决方案。

---

【正文开始】

问题背景

在 Qt 中，Q.openUrlExternally() 函数用于在系统默认的应用程序中打开指定的 URL。

然而，在处理文件 URL 时，由于Linux 和 Windows 平台的文件系统不同，将导致行为不一致。

具体来说：

• 在 Linux 下，文件路径通常以 / 开头，如 /usr/local。

• 在 Windows 下，文件路径通常以 卷名 开头，如 C:/Windows。

通常，如果我们想在 Qml 打开一个文件夹：

Qt.openUrlExternally("file:///" + dir);

• 在 Linux 下，结果是 file:usr/local，注意 这里是四个 /，因此这个 URL 是错误的，无法打开。

• 在 Windows 下，结果是 file:///C:/Windows，可以正确打开。

解决方案

1. 判断系统使用不同的前缀

我们可以通过 Qt.platform.os 判断当前所处的系统：

if (Qt.platform.os == "windows") {
    Qt.openUrlExternally("file:///" + dir);
} else {
    Qt.openUrlExternally("file://" + dir);
}

不过，这样做需要在 Qml 中进行条件判断，可能代码会有点冗余，而且如果以后有其他平台，还需要继续添加判断。

因此，更建议使用下面的方案：

2. 使用 QUrl 辅助处理本地文件

我们可以使用 QUrl::fromLocalFile 处理本地文件的情况，该函数能在不同的平台返回正确的 URL 结果。

QUrl toLocalUrl(const QString &dir)
{
    return QUrl::fromLocalFile(dir);
}

然后将该函数注册到 Qml 中调用即可：

Qt.openUrlExternally(toLocalUrl(dir));

---

【结语】

很多时候，我们在开发跨平台应用时，需要理解平台之间的差异。

总的来说，优先考虑使用 QUrl::fromLocalFile 这样的函数，来处理本地文件的 URL 转换，避免手动拼接带来的麻烦。