PyQt6调用QFileDialog.getOpenFileName弹出保存对话框如何解决

调用QFileDialog.getOpenFileName却弹出保存对话框、触发覆盖提示，核心是两类问题：

• 方法名手滑写错：IDE自动补全极易把getOpenFileName选成getSaveFileName，是该场景最高发的错误
• PyQt6对C++重载方法的位置参数解析存在匹配偏差，纯位置传参时可能错误匹配到保存对话框的方法签名，未正确加载打开文件的模式标记

• 先核对方法名，确认调用的是getOpenFileName而非getSaveFileName
• 全部使用关键字传参，不要用顺序位置传参，避免重载匹配错误
• 显式传入options参数，添加QFileDialog.Option.ReadOnly标记，强制对话框运行在打开文件模式，彻底避免覆盖提示弹出
• 文件过滤器的分隔符;;后不要加多余空格，避免过滤器解析异常
• 该调用逻辑必须放在窗口类的实例方法内部（比如按钮点击的槽函数里），不能直接写在全局作用域，否则self参数无有效引用会直接报错
• 注意getOpenFileName返回值是(文件路径, 选中过滤器)的二元组，需要用两个变量接收，不要用单个变量承接，否则后续操作文件时会拿到元组对象触发类型错误

from PyQt6.QtWidgets import QMainWindow, QApplication, QPushButton, QFileDialog
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.resize(800, 600)
        open_btn = QPushButton("选择文件", self)
        open_btn.clicked.connect(self.select_file)

    def select_file(self):
        file_path, selected_filter = QFileDialog.getOpenFileName(
            parent=self,
            caption="打开文件",
            directory="c:\\gui\\images",
            filter="All Files (*);;Python Files (*.py);;PNG Files (*.png)",
            options=QFileDialog.Option.ReadOnly
        )
        if file_path:
            # 此处写选中文件后的业务逻辑即可
            print(f"已选中文件：{file_path}")

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

如果加完上述配置仍然弹出异常对话框，可以在options里追加QFileDialog.Option.DontUseNativeDialog，禁用系统原生文件对话框，使用Qt自带的对话框组件，可规避部分Windows平台原生对话框的适配bug。

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