MacOS系统下PyQt5调用QFileDialog无法弹出对话框问题求助

这个报错是MacOS Catalina（10.15+）系统的XPC服务权限机制和PyQt5 5.15.x版本的文件对话框适配缺陷共同导致的：

• MacOS Catalina及以上版本引入了更严格的跨进程UI渲染权限控制，系统原生文件对话框依赖com.apple.view-bridge XPC服务渲染，直接通过终端运行的Python进程默认没有足够的权限和该服务建立稳定连接，就会触发连接中断报错
• PyQt5 5.15.x版本默认优先调用系统原生文件对话框，没有对Catalina的权限机制做兼容处理，偶发的权限校验失败就会导致对话框无法弹出，需要多次重启应用重试才能通过校验

方案1：禁用原生文件对话框（最通用，100%生效） #

直接修改QFileDialog的调用参数，添加DontUseNativeDialog选项，改用Qt自带的非原生文件对话框，完全绕开系统XPC服务的权限限制，修改后的open_file方法代码如下：

def open_file(self):
    file_name, _ = QFileDialog.getOpenFileName(
        self,
        "选择文件",
        "",
        "所有文件(*)",
        options=QFileDialog.DontUseNativeDialog
    )
    if file_name:
        # 后续业务逻辑
        ...

该方案不需要修改系统配置，也不需要降级依赖，修改后立刻生效，唯一的区别是文件对话框的样式会和Mac系统原生样式有细微差异。

方案2：保留原生对话框的处理方法 #

如果你需要使用Mac原生文件对话框的特性（比如侧边栏快速访问、隔空投送、标签页等），可以根据使用场景选择对应处理方式：

• 本地开发场景：给运行脚本的终端App（系统自带Terminal或者iTerm2）开启完全磁盘访问权限：打开「系统偏好设置→安全性与隐私→隐私→完全磁盘访问」，把终端App添加到权限列表，重启终端后再运行脚本即可正常调用原生对话框
• 分发用户场景：将Python脚本打包为标准的MacOS .app 应用包（可使用PyInstaller、py2app等工具实现），打包时在配置文件中添加文件访问权限声明，用户首次打开应用时系统会自动弹出权限申请，用户同意后即可正常使用原生对话框。

可选兼容方案 #

如果不想修改代码也不想调整系统权限，可以将PyQt5版本降级到5.12.x版本，该版本的文件对话框适配逻辑在MacOS Catalina上不存在该兼容问题，但该方案会缺失PyQt5 5.15版本的大量新特性，不推荐长期使用。

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