如何在PyQt5 GUI中显示后台线程类的输出到TextBrowser？

要实现后台线程输出显示到UI的TextBrowser，核心是利用Qt的信号与槽机制（子线程不能直接操作UI元素），具体修改如下：

1. 修正依赖导入冲突 #

你的代码同时导入了PyQt5和PySide2，这会导致兼容性问题，统一使用PySide2即可：

import sys 
from PySide2.QtCore import QThread, Signal, QApplication
from PySide2.QtWidgets import QMainWindow
from ui_test import Ui_MainWindow

2. 修改后台线程类，添加信号 #

在MainThread中定义一个信号，用于传递输出内容：

class MainThread(QThread):
    # 定义信号，参数为字符串类型
    output_signal = Signal(str)

    def __init__(self):
        super(MainThread, self).__init__()
        
    def run(self):
        self.task()
        
    def task(self):
        count = 0
        while True:
            com = f"running {count}"
            # 发送信号传递内容
            self.output_signal.emit(com)
            count += 1
            # 加个延时避免输出过快
            self.msleep(1000)

3. 连接信号与UI组件槽函数 #

在main类的初始化方法中，将后台线程的信号连接到TextBrowser的append方法：

startexecution = MainThread()

class main(QMainWindow):
    def __init__(self):
        super(main, self).__init__()
        self.ti = Ui_MainWindow()
        self.ti.setupUi(self)
        self.ti.run_btn.clicked.connect(self.starttask)
        self.ti.close.clicked.connect(self.close)
        
        # 连接信号与槽：后台输出 -> TextBrowser显示
        startexecution.output_signal.connect(self.ti.textBrowser.append)
        
        self.show()
        
    def starttask(self):
        startexecution.start()

4. 完整代码 #

import sys 
from PySide2.QtCore import QThread, Signal, QApplication
from PySide2.QtWidgets import QMainWindow
from ui_test import Ui_MainWindow


class MainThread(QThread):
    output_signal = Signal(str)

    def __init__(self):
        super(MainThread, self).__init__()
        
    def run(self):
        self.task()
        
    def task(self):
        count = 0
        while True:
            com = f"running {count}"
            self.output_signal.emit(com)
            count += 1
            self.msleep(1000)
        

startexecution = MainThread()

class main(QMainWindow):
    def __init__(self):
        super(main, self).__init__()
        self.ti = Ui_MainWindow()
        self.ti.setupUi(self)
        self.ti.run_btn.clicked.connect(self.starttask)
        self.ti.close.clicked.connect(self.close)
        
        startexecution.output_signal.connect(self.ti.textBrowser.append)
        
        self.show()
        
    def starttask(self):
        startexecution.start()
        
        

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

关键说明 #

• 子线程绝对不能直接操作UI元素，必须通过信号传递数据，由主线程（UI线程）处理显示逻辑，这是Qt的线程安全要求。
• 给后台线程添加msleep是为了避免输出过于频繁导致UI卡顿，你可以根据实际需求调整延时时间。

内容的提问来源于stack exchange，提问作者Yūjin-A