PyQt5 QProgressBar在QThread任务运行时不显示问题排查

问题原因 #

你的代码核心问题出在两处：

1. 窗口显示时机冲突：你选择文件后，文件选择模态对话框刚关闭，事件队列中还有残留的窗口关闭事件待处理，此时立即通过跨线程信号触发进度对话框的show()，会出现绘制冲突，导致对话框框架能出来但内部控件没有完成渲染。
2. Model实例复用错误：你把Controller初始化时创建的全局Model实例移到子线程，任务结束后又绑定了deleteLater销毁实例，第二次触发任务时会直接失效。
3. 额外小问题：你重复绑定了线程销毁的信号槽，还存在lambda持有局部变量的潜在风险。

解决方法 #

按如下步骤修改即可：

1. 调整进度对话框触发时机：不需要等子线程的start_task信号再显示进度框，在主线程拿到选中文件后、启动子线程前直接触发显示，用QTimer.singleShot错开文件对话框的关闭事件处理周期，修改Controller的on_press_open_button方法：

def on_press_open_button(self) -> None:
    if self.view.file_dialog.exec_() == QtWidgets.QDialog.Accepted:
        file_names = self.view.file_dialog.selectedFiles()
        self.view.progress_dialog.title = "正在打开文件..."
        # 直接触发进度框显示，错开事件冲突
        QtCore.QTimer.singleShot(0, self.view.progress_dialog.on_start)

        self.thread = QtCore.QThread()
        # 每次创建新的Model实例，不要复用全局的
        model = Model(controller=self)
        model.moveToThread(self.thread)

        self.thread.started.connect(lambda: model.open_file(file_names))
        self.thread.finished.connect(self.thread.deleteLater)

        # 删掉原来的start_task信号连接，我们已经提前触发显示了
        model.update_task.connect(
            lambda value: self.view.progress_dialog.on_update(value)
        )
        model.finish_task.connect(self.view.progress_dialog.on_finish)
        model.finish_task.connect(self.thread.quit)
        model.finish_task.connect(model.deleteLater)

        self.thread.start()

2. 给进度对话框加强制重绘：修改ProgressDialog的on_start方法，确保显示后立即重绘：

def on_start(self):
    self.setModal(True)
    self.show()
    self.raise_() # 把窗口提到最前避免被遮挡
    self.update() # 强制重绘控件

3. 删掉原来Controller初始化时创建全局Model的逻辑即可，避免无效实例残留。

修改后进度对话框就能正常显示，也不会出现后续点击打开文件失效的问题。

内容的提问来源于stack exchange，提问作者adam.hendry