PyQt5使用DontUseNativeDialog创建QFileDialog时报错“Could not create collator:4”

我之前在PyQt5项目里也碰到过一模一样的问题——启用DontUseNativeDialog后控制台报collator错误，虽然文件对话框能打开，但点击确认就二次报错，不用这个选项又得忍受原生对话框和Qt界面风格脱节的问题。下面是我亲测有效的几个解决方法：

1. 手动指定对话框的Locale和排序规则 #

报错的核心是Qt在非原生模式下无法自动创建用于文件排序的collator对象，我们可以手动给它明确的规则来绕过这个问题：

import sys
from PyQt5.QtCore import Qt, QLocale
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QFileDialog

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.init_ui()

    def init_ui(self):
        btn = QPushButton("Open File", self)
        btn.clicked.connect(self.open_file_dialog)
        self.setCentralWidget(btn)
        self.show()

    def open_file_dialog(self):
        dialog = QFileDialog(self)
        dialog.setOption(QFileDialog.DontUseNativeDialog, True)
        
        # 关键：设置明确的Locale，用系统默认或指定通用Locale
        dialog.setLocale(QLocale.system())
        # 强制设置排序方式，避免Qt尝试创建collator
        dialog.setSorting(Qt.CaseInsensitive)
        
        if dialog.exec_() == QFileDialog.Accepted:
            selected_file = dialog.selectedFiles()[0]
            print(f"Selected file: {selected_file}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    sys.exit(app.exec_())

2. 程序启动时设置全局Locale #

如果系统的Locale配置有问题（比如使用了Qt不完全支持的小众Locale），可以在程序启动时强制设置全局默认Locale：

from PyQt5.QtCore import QLocale

if __name__ == "__main__":
    # 启动时设置全局Locale，比如用系统默认或明确指定en_US.UTF-8
    QLocale.setDefault(QLocale.system())
    # 或者 QLocale.setDefault(QLocale(QLocale.English, QLocale.UnitedStates))
    
    app = QApplication(sys.argv)
    window = MainWindow()
    sys.exit(app.exec_())

3. 升级PyQt5到稳定新版本 #

这个collator创建失败的bug在旧版PyQt5（比如Qt 5.10及更早）里比较常见，升级到5.15.x这类稳定的新版本，官方已经修复了不少Locale相关的兼容性问题。

4. 自定义文件选择对话框（终极方案） #

如果以上方法都不生效，你可以自己基于QDialog+QTreeView实现一个自定义文件选择框，完全控制样式和逻辑，彻底绕过Qt自带对话框的问题。虽然需要多写一点代码，但能保证样式和你的Qt界面完全统一。

补充：错误原因说明 #

"Could not create collator: 4"这个错误，本质是Qt在非原生对话框模式下，尝试创建用于文件列表排序的collator（排序器）对象时初始化失败。错误码4一般对应Locale初始化相关的问题，多数是系统Locale不被Qt完全支持，或者Qt的Locale模块加载异常导致的。

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