如何将sys.stdout重定向至多个独立的PyQt Widget组件？

问题代码 #

class EmitStr(QObject):
    update_info_signal = pyqtSignal(str)

    def write(self, text):
        self.update_info_signal.emit(str(text))
        QApplication.processEvents()

sys.stdout = EmitStr()
sys.stdout.update_info_signal.connect(self.update_info)

问题描述 #

单窗口场景下可正常将print内容重定向到textBrowser，但打开第二个窗口后，所有线程的打印内容都会显示在晚打开的窗口中。核心原因是sys.stdout是进程全局单例，每次新窗口初始化时都会覆盖它，导致所有输出都指向最后一个绑定的窗口组件。

需求：不使用logging模块，不修改现有代码中的print及其他函数，实现多窗口独立接收各自线程的输出。

解决方案 #

利用线程局部存储（threading.local）为每个线程绑定专属的输出信号，让不同线程的print内容发送到对应窗口的textBrowser：

import threading
from PyQt5.QtCore import QObject, pyqtSignal
from PyQt5.QtWidgets import QApplication
import sys

class ThreadLocalStdout(QObject):
    # 用线程局部变量存储每个线程的专属信号
    _local = threading.local()

    @classmethod
    def get_thread_signal(cls):
        if not hasattr(cls._local, 'signal'):
            cls._local.signal = pyqtSignal(str)
        return cls._local.signal

    def write(self, text):
        # 向当前线程绑定的信号发送内容
        try:
            self.get_thread_signal().emit(str(text))
            QApplication.processEvents()
        except AttributeError:
            # 未绑定信号的线程，内容输出到原始stdout
            sys.__stdout__.write(text)

# 全局仅替换一次stdout，无需每个窗口重复操作
sys.stdout = ThreadLocalStdout()

窗口绑定示例 #

每个窗口初始化时，将自身的textBrowser更新方法绑定到当前线程的信号：

from PyQt5.QtWidgets import QWidget, QTextBrowser, QVBoxLayout, QPushButton
from PyQt5.QtCore import QThread

class MyWindow(QWidget):
    def __init__(self, window_title):
        super().__init__()
        self.setWindowTitle(window_title)
        self.layout = QVBoxLayout(self)
        
        self.textBrowser = QTextBrowser()
        self.start_btn = QPushButton("启动任务")
        self.start_btn.clicked.connect(self.start_task)
        
        self.layout.addWidget(self.textBrowser)
        self.layout.addWidget(self.start_btn)
        
        # 绑定当前线程的信号到窗口的更新方法
        ThreadLocalStdout.get_thread_signal().connect(self.update_info)

    def update_info(self, text):
        self.textBrowser.append(text)

    def start_task(self):
        # 启动独立工作线程执行任务
        self.thread = QThread()
        self.thread.run = self.task_func
        self.thread.start()

    def task_func(self):
        for i in range(1, 11):
            print(f"{self.windowTitle()} 输出: {i}")
            import time
            time.sleep(0.5)

原理说明 #

1. ThreadLocalStdout通过threading.local()为每个线程维护独立的pyqtSignal实例，彻底避免全局单例冲突。
2. 全局仅替换一次sys.stdout，无需每个窗口重复赋值。
3. 每个窗口初始化时绑定当前线程的信号，工作线程启动后，线程内的print会触发对应线程的信号，将内容输出到所属窗口的textBrowser。

这样既满足了不修改原有print调用、不使用logging的要求，又实现了多窗口独立接收各自线程输出的目标。

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