PyQt6中QFileDialog选择文件后无法关闭问题求助

我编写了一个使用PyQt6打开文件对话框选择文件的简单函数，功能可正常执行，但选择文件后对话框会挂起，无法自动关闭。

函数代码 #

def ui_find_file(title=None, initialdir=None, file_type=None):
    import os
    from PyQt6.QtWidgets import QApplication, QFileDialog

    app = QApplication([])
    file_dialog = QFileDialog()
    file_dialog.setFileMode(QFileDialog.FileMode.ExistingFile)

    if file_type:
        filter = f"{file_type} files (*.{file_type})"
        file_dialog.setNameFilter(filter)
    else:
        file_dialog.setNameFilter("All files (*);;")

    if initialdir is None:
        initialdir = os.getcwd()
    elif initialdir == '~':
        initialdir = os.path.expanduser('~')

    file_dialog.setDirectory(initialdir)

    if title:
        file_dialog.setWindowTitle(title)

    if file_dialog.exec():
        file_path = file_dialog.selectedFiles()[0]
        print(f"Selected {file_path}")
        file_dialog.deleteLater()  # Clean up the file dialog window
        app.quit()  # Exit the event loop
        return file_path
    else:
        print("No file selected")
        file_dialog.deleteLater()  # Clean up the file dialog window
        app.quit()  # Exit the event loop
        return None

测试情况 #

• 在命令行单独执行以下代码，调用file_dialog.open()或file_dialog.exec()，选择文件后对话框可正常关闭，Python进程不会冻结，甚至无需调用file_dialog.deleteLater()：

from PyQt6.QtWidgets import QApplication, QFileDialog

app = QApplication([])
file_dialog = QFileDialog()
file_dialog.setFileMode(QFileDialog.FileMode.ExistingFile)

• 但从其他脚本中导入并调用该函数时，就会出现对话框冻结的情况：

from utils import ui_find_file
ui_find_file()

环境与已尝试的无效操作 #

环境：Python 3.10、Ubuntu 20.04，终端运行。
已尝试但无效的操作：

• 用destroy()替代deleteLater()
• 在destroy()后调用app.processEvents()并执行del(app)

必须创建QApplication的原因 #

若不创建app = QApplication([])，会触发如下报错：

Python 3.10.6 (main, Mar 10 2023, 10:55:28) [GCC 11.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from utils import ui_find_file
>>> ui_find_file()
QWidget: Must construct a QApplication before a QWidget
Aborted (core dumped)

解决方案 #

问题核心在于每次调用函数都创建新的QApplication实例，干扰了事件循环的正常收尾。以下是修复后的代码：

def ui_find_file(title=None, initialdir=None, file_type=None):
    import os
    from PyQt6.QtWidgets import QApplication, QFileDialog

    # 检查是否已有QApplication实例，避免重复创建
    app = QApplication.instance()
    if app is None:
        app = QApplication([])

    file_dialog = QFileDialog()
    file_dialog.setFileMode(QFileDialog.FileMode.ExistingFile)

    if file_type:
        filter = f"{file_type} files (*.{file_type})"
        file_dialog.setNameFilter(filter)
    else:
        file_dialog.setNameFilter("All files (*);;")

    if initialdir is None:
        initialdir = os.getcwd()
    elif initialdir == '~':
        initialdir = os.path.expanduser('~')

    file_dialog.setDirectory(initialdir)

    if title:
        file_dialog.setWindowTitle(title)

    result = file_dialog.exec()
    file_path = file_dialog.selectedFiles()[0] if result else None

    if result:
        print(f"Selected {file_path}")
    else:
        print("No file selected")

    # 仅当当前实例是我们创建的QApplication时，才执行退出和事件处理
    if app is None:
        app.quit()
        app.processEvents()
    
    return file_path

关键修改说明 #

1. 复用QApplication实例：通过QApplication.instance()检查是否已有应用实例，避免重复创建导致的事件循环冲突，这是解决冻结问题的核心。
2. 简化资源清理：exec()是阻塞式调用，对话框执行完毕后会自动销毁自身，无需手动调用deleteLater()。
3. 正确收尾事件循环：仅在我们主动创建QApplication时才调用app.quit()，并通过app.processEvents()确保所有剩余事件处理完成，避免进程挂起。

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