如何在PyQt5的QFileDialog右键菜单添加“在文件夹中显示”功能？

要实现和Firefox同款的“在文件夹中显示”功能，核心是给非原生QFileDialog的文件视图添加自定义右键菜单，并实现跨平台打开文件所在目录并选中目标文件的逻辑，具体实现如下：

1. 实现跨平台打开文件目录并选中的逻辑 #

不同操作系统需要调用对应系统命令来完成操作：

• Windows：使用explorer.exe /select,"文件路径"
• macOS：使用open -R "文件路径"
• Linux：通过xdg-open "文件所在目录"兼容多数桌面环境

2. 给QFileDialog的文件视图添加自定义右键菜单 #

因为启用了DontUseNativeDialog选项，我们可以直接获取对话框内部的文件列表视图，为其添加自定义上下文菜单动作。

完整实现代码 #

import sys
import os
import subprocess
from PyQt5.QtWidgets import (QApplication, QWidget, QFileDialog, 
                             QMenu, QAction)
from PyQt5.QtCore import Qt

class App(QWidget):
    def __init__(self):
        super().__init__()
        self.title = 'PyQt5 文件对话框'
        self.left = 10
        self.top = 10
        self.width = 640
        self.height = 480
        self.initUI()

    def initUI(self):
        self.setWindowTitle(self.title)
        self.setGeometry(self.left, self.top, self.width, self.height)
        self.openFileNameDialog()
        self.show()

    def open_file_in_explorer(self, file_path):
        """打开文件所在目录并选中该文件"""
        if not os.path.exists(file_path):
            return
        try:
            if sys.platform.startswith('win32'):
                subprocess.run(['explorer.exe', '/select,', file_path], check=True)
            elif sys.platform.startswith('darwin'):
                subprocess.run(['open', '-R', file_path], check=True)
            elif sys.platform.startswith('linux'):
                dir_path = os.path.dirname(file_path)
                subprocess.run(['xdg-open', dir_path], check=True)
        except subprocess.CalledProcessError:
            pass

    def openFileNameDialog(self):
        options = QFileDialog.Options()
        options |= QFileDialog.DontUseNativeDialog
        dialog = QFileDialog(self, "选择文件", "", "Text Files (*.txt)")
        dialog.setOptions(options)

        # 获取对话框内的文件视图组件
        file_view = dialog.findChild(QFileDialog, "listView")
        if not file_view:
            file_view = dialog.findChild(QFileDialog, "treeView")

        if file_view:
            file_view.setContextMenuPolicy(Qt.CustomContextMenu)
            def show_context_menu(pos):
                index = file_view.indexAt(pos)
                if not index.isValid():
                    return
                file_path = dialog.selectedFiles()[0] if dialog.selectedFiles() else ""
                if not file_path:
                    return

                # 构建上下文菜单
                menu = QMenu()
                show_in_folder_action = QAction("在文件夹中显示", self)
                show_in_folder_action.triggered.connect(lambda: self.open_file_in_explorer(file_path))
                menu.addAction(show_in_folder_action)
                
                # 保留原有标准菜单
                original_menu = file_view.createStandardContextMenu()
                if original_menu:
                    menu.addSeparator()
                    menu.addMenu(original_menu)
                
                menu.exec_(file_view.mapToGlobal(pos))

            file_view.customContextMenuRequested.connect(show_context_menu)

        if dialog.exec_():
            fileName = dialog.selectedFiles()[0]
            print(fileName)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = App()
    sys.exit(app.exec_())

关键部分说明 #

• open_file_in_explorer函数：针对不同系统调用对应命令，加入异常处理避免命令执行失败导致程序崩溃。
• 文件视图获取：通过findChild查找Qt非原生对话框内置的listView或treeView组件，这是Qt的标准命名规则。
• 上下文菜单：启用自定义菜单策略后，在右键点击时生成包含自定义动作的菜单，同时保留原有标准菜单选项，不影响对话框原有功能。

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