是否可永久修改QFileDialog的“Choose”按钮显示文本？

之所以切换文件夹后“Choose”按钮文本会复原，是因为QFileDialog内部视图刷新时会重新初始化按钮文本，单次调用setButtonText只会生效到下次界面重绘/状态更新前。我们可以通过事件过滤器监听控件状态变化的方案实现持久化修改，该方案和之前侧边栏自定义委托的核心逻辑一致，都是通过hook组件的状态变更事件，自动同步自定义配置。 #

实现步骤 #

1. 自定义事件过滤器类 #

用于监听QFileDialog的所有界面更新事件，每次界面变动时自动同步确认按钮的自定义文本：

from PyQt5.QtCore import QObject, QEvent
from PyQt5.QtWidgets import QFileDialog, QDialogButtonBox

class FileDialogBtnTextFixer(QObject):
    def __init__(self, dialog, custom_accept_text):
        super().__init__(dialog)
        self.dialog = dialog
        self.custom_text = custom_accept_text
        # 给文件对话框挂载事件过滤器
        self.dialog.installEventFilter(self)
        # 初始化时先设置一次文本
        self._sync_btn_text()

    def _sync_btn_text(self):
        # 找到对话框内部的按钮容器
        button_box = self.dialog.findChild(QDialogButtonBox)
        if not button_box:
            return
        # 遍历所有确认类型的按钮，修改文本
        for accept_btn in button_box.buttons(QDialogButtonBox.AcceptRole):
            if accept_btn.text() != self.custom_text:
                accept_btn.setText(self.custom_text)

    def eventFilter(self, obj, event):
        # 监听所有会触发界面重置的事件
        if event.type() in (
            QEvent.LayoutRequest,
            QEvent.ChildAdded,
            QEvent.Show,
            QEvent.UpdateRequest
        ):
            self._sync_btn_text()
        return super().eventFilter(obj, event)

2. 调用方式 #

注意不要使用QFileDialog.getExistingDirectory这类静态方法，需要手动实例化QFileDialog，否则无法挂载事件过滤器：

# 手动实例化文件对话框，不要使用静态方法
dialog = QFileDialog()
# 强制使用Qt自带对话框，禁用系统原生对话框（否则找不到内部控件）
dialog.setOption(QFileDialog.DontUseNativeDialog, True)
# 配置为文件夹选择模式
dialog.setFileMode(QFileDialog.Directory)
dialog.setOption(QFileDialog.ShowDirsOnly, True)
# 挂载文本修复器，传入自定义的确认按钮文本
fixer = FileDialogBtnTextFixer(dialog, custom_accept_text="选择目标文件夹")
# 弹出对话框
if dialog.exec_() == QFileDialog.Accepted:
    selected_dir = dialog.selectedFiles()[0]

方案说明 #

该方案完全可以参考侧边栏委托的实现思路，二者的核心逻辑都是绕过组件默认的重绘规则，将自定义配置的更新逻辑绑定到组件的全生命周期事件中，只要组件发生任何可能重置UI的操作（比如切换文件夹、侧边栏刷新、窗口大小调整），监听器都会自动把按钮文本改回自定义值，不会出现切换文件夹后文本复原的问题。
如果是C开发场景，只要把上述Python逻辑对应改写为C语法即可，底层实现逻辑完全一致。

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