Qt 5.15.2下VS Code使用FileDialog选文件夹触发Segmentation fault问题

问题背景 #

使用Qt 5.15.2开发QML项目时，在VS Code中运行代码，当FileDialog设置selectFolder: true时会触发Segmentation fault (core dumped)错误，但相同代码在Qt Creator中运行完全正常。相关QML代码如下：

FileDialog {
    id: fileDialog
    title: "Please choose a file"
    folder: shortcuts.home
    selectFolder: true
    
    onAccepted: {
        console.log("You chose: " + fileDialog.fileUrls)
    }
    onRejected: {
        console.log("Canceled")
    }
}

排查方向与解决方案 #

• 验证VS Code的Qt环境一致性

  1. 在VS Code终端执行qmake -v，确认使用的Qt版本与Qt Creator完全一致，避免版本不匹配导致的问题。
  2. 检查.vscode/launch.json的environment配置，确保QT_QPA_PLATFORM_PLUGIN_PATH等关键环境变量指向Qt 5.15.2对应平台的插件目录（例如Linux下为Qt5.15.2/5.15.2/gcc_64/plugins/platforms）。

• 调整QML代码细节

  1. 将folder: shortcuts.home替换为绝对路径（如folder: "file:///home/your-username"），规避shortcuts可能存在的环境依赖问题。
  2. 修正fileUrls的输出方式，避免直接拼接数组触发未定义行为：

     onAccepted: {
         fileDialog.fileUrls.forEach(url => console.log("You chose: " + url))
     }
     

• 更新Qt补丁版本
  Qt 5.15系列为长期支持版本，5.15.2存在部分已知的QML FileDialog平台适配bug，尝试安装Qt 5.15.2的最新补丁包，修复潜在的底层问题。

• 排查VS Code插件与构建配置

  1. 确认.vscode/tasks.json的构建任务使用与Qt Creator相同的编译套件（如gcc版本、编译参数），消除编译差异。
  2. 临时禁用VS Code中可能干扰Qt运行的第三方插件（如文件监控、调试增强类插件），排查是否存在插件冲突。

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