如何在PyQt5的QFileDialog中使用多个自定义过滤器？

要实现多自定义过滤器并在下拉框切换，核心思路是：禁用原生对话框、创建自定义代理模型、替换文件类型组合框选项、绑定切换事件动态更新过滤规则。以下提供两种可行实现方式：

方式一：单代理模型切换过滤规则 #

通过一个代理模型内置多种过滤模式，切换时修改模式并刷新过滤，效率更高：

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

class FilterProxyModel(QtCore.QSortFilterProxyModel):
    # 定义过滤模式枚举
    FilterModeAll = 0
    FilterModeNoDot = 1

    def __init__(self, mode=FilterModeAll, parent=None):
        super().__init__(parent)
        self._filter_mode = mode

    def setFilterMode(self, mode):
        self._filter_mode = mode
        self.invalidateFilter()  # 触发过滤规则刷新

    def filterAcceptsRow(self, source_row, source_parent):
        model = self.sourceModel()
        index = model.index(source_row, 0, source_parent)
        
        # 目录始终显示
        if model.isDir(index):
            return True
        
        # 根据当前模式判断文件是否显示
        if self._filter_mode == self.FilterModeAll:
            return True
        elif self._filter_mode == self.FilterModeNoDot:
            return '.' not in model.fileName(index)
        return True

    def sort(self, column, order):
        # 委托排序逻辑给源模型
        self.sourceModel().sort(column, order)


class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setGeometry(100, 100, 300, 200)
        self.setWindowTitle('File Dialog Custom Filters')
        self.button = QPushButton('Open File Dialog')
        self.button.clicked.connect(self.showFileDialog)
        self.setCentralWidget(self.button)


    def showFileDialog(self):
        dialog = QFileDialog()
        dialog.setOption(QFileDialog.DontUseNativeDialog)
        
        # 创建可切换模式的代理模型
        proxy = FilterProxyModel(parent=dialog)
        dialog.setProxyModel(proxy)
        
        # 获取文件类型组合框（精准匹配控件名称）
        file_type_combo = dialog.findChild(QComboBox, "fileTypeCombo")
        # 清空默认选项，添加自定义过滤器
        file_type_combo.clear()
        file_type_combo.addItem("无点文件(*.*)", FilterProxyModel.FilterModeNoDot)
        file_type_combo.addItem("所有文件(*)", FilterProxyModel.FilterModeAll)
        
        # 绑定组合框切换事件，更新过滤模式
        def on_filter_switch(index):
            mode = file_type_combo.itemData(index)
            proxy.setFilterMode(mode)
        
        file_type_combo.currentIndexChanged.connect(on_filter_switch)
        
        # 默认选中第一个自定义过滤器
        file_type_combo.setCurrentIndex(0)
        
        if dialog.exec_():
            if selected_files := dialog.selectedFiles():
                print("Selected file: ", selected_files[0])


if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MyWindow()
    window.show()
    sys.exit(app.exec_())

方式二：多独立代理模型切换 #

为每个过滤器创建独立的代理模型，切换时直接替换对话框的代理模型，逻辑更直观：

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

class NoDotProxyModel(QtCore.QSortFilterProxyModel):
    def filterAcceptsRow(self, source_row, source_parent):
        model = self.sourceModel()
        index = model.index(source_row, 0, source_parent)
        # 显示目录和名称不含点的文件
        return model.isDir(index) or '.' not in model.fileName(index)

    def sort(self, column, order):
        self.sourceModel().sort(column, order)


class AllFilesProxyModel(QtCore.QSortFilterProxyModel):
    def filterAcceptsRow(self, source_row, source_parent):
        # 显示所有目录和文件
        model = self.sourceModel()
        index = model.index(source_row, 0, source_parent)
        return True

    def sort(self, column, order):
        self.sourceModel().sort(column, order)


class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setGeometry(100, 100, 300, 200)
        self.setWindowTitle('File Dialog Custom Filters')
        self.button = QPushButton('Open File Dialog')
        self.button.clicked.connect(self.showFileDialog)
        self.setCentralWidget(self.button)


    def showFileDialog(self):
        dialog = QFileDialog()
        dialog.setOption(QFileDialog.DontUseNativeDialog)
        
        # 创建两个独立的代理模型
        no_dot_proxy = NoDotProxyModel(parent=dialog)
        all_files_proxy = AllFilesProxyModel(parent=dialog)
        
        # 获取文件类型组合框
        file_type_combo = dialog.findChild(QComboBox, "fileTypeCombo")
        file_type_combo.clear()
        # 添加选项并绑定对应的代理模型
        file_type_combo.addItem("无点文件(*.*)", no_dot_proxy)
        file_type_combo.addItem("所有文件(*)", all_files_proxy)
        
        # 绑定切换事件，替换代理模型
        def on_filter_switch(index):
            selected_proxy = file_type_combo.itemData(index)
            dialog.setProxyModel(selected_proxy)
        
        file_type_combo.currentIndexChanged.connect(on_filter_switch)
        
        # 默认设置第一个代理模型
        dialog.setProxyModel(no_dot_proxy)
        file_type_combo.setCurrentIndex(0)
        
        if dialog.exec_():
            if selected_files := dialog.selectedFiles():
                print("Selected file: ", selected_files[0])


if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MyWindow()
    window.show()
    sys.exit(app.exec_())

关键说明 #

1. 必须禁用原生对话框：只有Qt自绘的对话框（DontUseNativeDialog选项）才能修改内部控件，原生系统对话框无法操作。
2. 精准查找组合框：通过findChild(QComboBox, "fileTypeCombo")直接匹配Qt默认的文件类型组合框名称，避免误操作其他下拉控件。
3. 过滤刷新机制：方式一通过invalidateFilter()触发规则刷新，方式二直接替换代理模型，两种方式都能确保视图实时更新。

内容的提问来源于stack exchange，提问作者The rag on din