PyQt5中QFileDialog的QDialogButtonBox.Open按钮setText失效问题求助

问题现象 #

在PyQt5中使用QFileDialog时，修改QDialogButtonBox.Open按钮的文本后会出现异常：当在文件列表中选中文件时，该按钮会自动恢复为原始文本，但QDialogButtonBox.Cancel按钮不存在这个问题。

初始复现代码 #

import sys
import os

from PyQt5.QtWidgets import (QFileDialog, QDialogButtonBox, QApplication, QListView)
from PyQt5.QtCore import (QCoreApplication, QMetaObject)

class OpenFileDialog(QFileDialog):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

        # 初始路径
        self.path = os.getcwd()

        options = self.Options()
        options = self.DontUseNativeDialog
        self.setOptions(options)

        # 处理确认和取消按钮
        d_button = self.findChild(QDialogButtonBox, "buttonBox")
        d_button.setFixedWidth(110)
        self.but_ok = d_button.button(QDialogButtonBox.Open)
        self.but_ok.setText("Seleccionar")
        self.but_cancel = d_button.button(QDialogButtonBox.Cancel)
        self.but_cancel.setText("Cancelar")

        self.but_ok.clicked.connect(self.click_ok_button)
        self.but_cancel.clicked.connect(self.click_cancel_button)

        # 临时解决方案
        fil_lst = self.findChild(QListView, "listView")
        fil_lst.clicked.connect(self.selectitem)

    def selectitem(self):
        self.but_ok.setText("Seleccionar")

    def click_ok_button(self):
        print("Select file")

    def click_cancel_button(self):
        self.close()

    def closeEvent(self, event):
        print("Select None")

if __name__ == '__main__':
    app = QApplication(sys.argv)
    dialog = OpenFileDialog()
    dialog.show()
    sys.exit(app.exec())

临时方案的局限 #

上述代码通过监听文件列表的点击事件，每次点击时重新设置按钮文本，虽然能解决问题，但实现方式不够优雅，不符合Pythonic的代码风格。

问题根源 #

QFileDialog会根据当前选中的项目（文件或目录）动态更新“Accept”按钮的文本，而非静态保持用户设置的文本值，这就是直接修改Open按钮文本后会被重置的原因。

最终解决方案：替换Open按钮 #

最佳方案是移除原有的Open按钮，添加一个自定义的Accept角色按钮，这样就能完全控制按钮文本，避免被动态重置。最终代码如下：

import sys
import os

from PyQt5.QtWidgets import (QFileDialog, QDialogButtonBox, QApplication, QStyle)

class OpenFileDialog(QFileDialog):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

        # 初始路径
        self.path = os.getcwd()

        options = self.Options()
        options = self.DontUseNativeDialog
        self.setOptions(options)

        # 设置取消按钮文本
        self.setLabelText(OpenFileDialog.Reject, "Cancelar")
        d_button = self.findChild(QDialogButtonBox, "buttonBox")
        self.but_cancel = d_button.button(QDialogButtonBox.Cancel)

        # 替换Open按钮为自定义按钮
        d_button.removeButton(d_button.button(QDialogButtonBox.Open))
        self.but_accept = d_button.addButton("Seleccionar", QDialogButtonBox.AcceptRole)
        icon = self.style().standardIcon(QStyle.SP_FileIcon)
        self.but_accept.setIcon(icon)

        self.but_accept.clicked.connect(self.click_accept_button)
        self.but_cancel.clicked.connect(self.click_cancel_button)

    def click_accept_button(self):
        print("Select file")

    def click_cancel_button(self):
        self.close()

    def closeEvent(self, event):
        print("Select None")

if __name__ == '__main__':
    app = QApplication(sys.argv)
    dialog = OpenFileDialog()
    dialog.show()
    sys.exit(app.exec())

内容的提问来源于stack exchange，提问作者Manuel Antón