如何在PyQt5的QFileDialog中实现打开时预选中多个文件

问题根因 #

QFileDialog内置的selectFile()方法默认是覆盖选中模式，每次调用会清空之前的选中状态，因此循环调用后仅最后一个文件会保持选中。

修复后可运行代码 #

from PyQt5 import QtWidgets
from PyQt5.QtCore import Qt
import sys

class Window(QtWidgets.QWidget):
    def __init__(self):
        super(Window, self).__init__()
        self.button = QtWidgets.QPushButton('Test', self)
        self.button.clicked.connect(self.handle_button)
        layout = QtWidgets.QVBoxLayout(self)
        layout.addWidget(self.button)

    def handle_button(self):
        options = QtWidgets.QFileDialog.Options()
        options |= QtWidgets.QFileDialog.DontUseNativeDialog
        ref_dir = 'D:\\temp'
        files_list = ['file1.txt', 'file2.txt', 'file3.txt']
        fd = QtWidgets.QFileDialog(None, 'Choose project files', ref_dir, '(*.txt)')
        fd.setFileMode(QtWidgets.QFileDialog.ExistingFiles)
        fd.setOptions(options)

        # 预选中逻辑实现
        original_show_event = fd.showEvent
        def pre_select_files(e):
            original_show_event(e)
            # 获取对话框内置的文件列表视图
            list_view = fd.findChild(QtWidgets.QListView, "listView")
            if not list_view:
                return
            model = list_view.model()
            sel_model = list_view.selectionModel()
            # 遍历列表匹配需要预选中的文件
            for row in range(model.rowCount()):
                idx = model.index(row, 0)
                current_file = model.data(idx, Qt.DisplayRole)
                if current_file in files_list:
                    # 追加选中，不清空已有选中状态
                    sel_model.select(idx, sel_model.Select | sel_model.Rows)

        fd.showEvent = pre_select_files

        exec_result = fd.exec()
        if exec_result:
            selected_files = fd.selectedFiles()
            print(f'选中的文件列表: {selected_files}')

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

关键说明 #

• 必须使用非原生对话框（即保留DontUseNativeDialog配置），原生系统文件对话框无法获取内部控件实现自定义选中逻辑
• 匹配文件名时可根据系统大小写敏感性调整匹配规则，避免Linux/macOS环境下匹配失败
• 选中时使用Select标记而非ClearAndSelect，保证选中多个文件时不会互相覆盖

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