PyQt5如何实现程序运行时的非阻塞等待提示对话框？

核心问题在于你用了exec_()打开模态对话框，它会阻塞主线程的事件循环，导致后续的API操作根本无法执行。正确的做法是结合非模态对话框和子线程，把耗时的API交互放到后台，同时在前台显示等待提示。

具体实现步骤 #

1. 改造等待对话框 #

给对话框添加窗口模态属性（只阻塞主窗口，不阻塞整个程序），并移除关闭按钮防止用户提前中断：

from PyQt5 import QtWidgets, QtCore

class WaitDialog(QtWidgets.QDialog, UiWaitWindow):
    def __init__(self, parent=None):
        QtWidgets.QDialog.__init__(self, parent)
        self.setup_ui(self)
        # 设置只阻塞父窗口（主窗口）
        self.setWindowModality(QtCore.Qt.WindowModal)
        # 隐藏关闭按钮，避免用户手动关闭
        self.setWindowFlags(QtCore.Qt.Window | QtCore.Qt.CustomizeWindowHint | QtCore.Qt.WindowTitleHint)

2. 创建后台工作线程 #

把耗时的API交互逻辑放到QThread中，避免卡主UI：

from PyQt5.QtCore import QThread, pyqtSignal

class ApiWorker(QThread):
    # 定义任务完成信号，可传递返回的文档数据
    task_finished = pyqtSignal(object)

    def __init__(self, user_info):
        super().__init__()
        self.user_info = user_info  # 传递用户输入的信息

    def run(self):
        # 这里替换成你的API交互函数
        result_doc = your_api_processing_function(self.user_info)
        # 任务完成后发送信号通知主线程
        self.task_finished.emit(result_doc)

3. 主窗口中调用逻辑 #

在主窗口触发任务的函数里，启动对话框和线程，绑定信号处理：

class MainWindow(QtWidgets.QMainWindow):
    # ... 你的主窗口代码 ...

    def start_processing(self):
        # 显示等待对话框
        self.wait_dlg = WaitDialog(self)
        self.wait_dlg.show()

        # 收集用户输入的信息（替换成你的实际逻辑）
        user_info = {
            "name": self.name_input.text(),
            "email": self.email_input.text()
            # 其他用户信息字段
        }

        # 启动后台线程
        self.worker = ApiWorker(user_info)
        self.worker.task_finished.connect(self.on_processing_finished)
        self.worker.start()

    def on_processing_finished(self, result_doc):
        # 关闭等待对话框
        self.wait_dlg.close()
        # 处理返回的文档（替换成你的实际逻辑）
        self.display_result(result_doc)

关键说明 #

• 用show()代替exec_()：show()是非模态显示，不会阻塞主线程的事件循环，后台线程可以正常运行。
• 窗口模态设置：WindowModal让用户无法操作主窗口，但不影响后台线程执行，避免用户误操作。
• 线程安全：Qt的信号槽机制是线程安全的，线程完成后通过信号通知主线程更新UI，避免直接在子线程操作UI。

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