如何在PyQt5的QTextEdit中实时重定向子线程的stdout？

我帮你搞定这个实时输出的问题！你遇到的情况很典型——当你在主线程里运行耗时进程时，整个GUI会被阻塞，直到进程结束才会一次性刷新所有输出。下面是一套完整的解决方案，用多线程+stdout重定向的方式，完美实现QTextEdit的实时更新：

核心思路 #

1. 把耗时的进程逻辑放到子线程中，避免阻塞主GUI线程
2. 重定向系统标准输出（stdout），将输出内容通过Qt的信号槽机制传递到主线程
3. 在主线程中接收信号，更新QTextEdit内容（信号槽是Qt线程安全的，不会出现跨线程操作GUI的问题）

完整代码示例 #

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QTextEdit, 
                             QPushButton, QVBoxLayout, QWidget)
from PyQt5.QtCore import QThread, pyqtSignal, QObject
import time

# 自定义stdout重定向类，将输出转为信号
class RedirectStdout(QObject):
    # 定义传递文本的信号
    text_written = pyqtSignal(str)

    def write(self, text):
        # 过滤空行（避免stdout输出空字符串干扰显示）
        if text.strip():
            self.text_written.emit(text)
    
    def flush(self):
        # 必须实现flush方法，否则sys.stdout会抛出AttributeError
        pass

# 工作线程类，用于执行耗时任务
class WorkerThread(QThread):
    def run(self):
        # 这里替换成你的实际耗时进程逻辑
        # 示例：模拟分步输出的任务
        for i in range(10):
            print(f"正在执行第 {i+1} 步...")
            time.sleep(1)
        print("✅ 任务完成！")

# 主窗口类
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.init_ui()
        self.setup_stdout_redirect()

    def init_ui(self):
        self.setWindowTitle("实时输出演示")
        self.setGeometry(100, 100, 600, 400)

        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        layout = QVBoxLayout(central_widget)

        # 创建用于显示输出的QTextEdit
        self.text_edit = QTextEdit()
        self.text_edit.setReadOnly(True)  # 设置为只读，防止用户误操作
        layout.addWidget(self.text_edit)

        # 创建启动任务的按钮
        self.start_btn = QPushButton("开始执行任务")
        self.start_btn.clicked.connect(self.start_task)
        layout.addWidget(self.start_btn)

    def setup_stdout_redirect(self):
        # 初始化重定向对象，并连接信号到QTextEdit
        self.stdout_redirect = RedirectStdout()
        self.stdout_redirect.text_written.connect(self.text_edit.append)
        # 替换系统stdout为自定义对象
        sys.stdout = self.stdout_redirect

    def start_task(self):
        # 禁用按钮防止重复点击
        self.start_btn.setEnabled(False)
        # 创建并启动工作线程
        self.worker_thread = WorkerThread()
        # 线程结束后恢复按钮状态
        self.worker_thread.finished.connect(lambda: self.start_btn.setEnabled(True))
        self.worker_thread.start()

    def closeEvent(self, event):
        # 程序关闭时恢复系统stdout，避免后续输出异常
        sys.stdout = sys.__stdout__
        event.accept()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

关键细节说明 #

• 线程安全的GUI更新：直接在子线程中操作QTextEdit会触发Qt的线程安全警告，通过信号槽传递内容，Qt会自动处理线程间的消息传递，确保GUI更新安全。
• stdout重定向的必要性：自定义RedirectStdout类实现了write方法，替代了默认的stdout输出逻辑，把原本打印到控制台的内容转为信号发送。
• 恢复stdout：在窗口关闭事件中把sys.stdout恢复为原始对象，避免程序退出后Python的标准输出功能异常。

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