如何在PyQt5中通过子线程编辑QPlainTextEdit控件的文本内容

你判断的问题根因完全正确：Qt规定所有GUI控件的操作必须在主线程（GUI线程）中执行，子线程直接操作QPlainTextEdit会触发线程安全问题，表现为界面无响应、崩溃、内容显示异常等。

解决方案：使用Qt跨线程安全的信号槽机制实现数据传递 #

1. 定义自定义信号并绑定槽函数

在你的类（主窗口/串口管理类）中新增字符串类型的自定义信号，并且将信号和UI更新的槽函数绑定：

from PyQt5.QtCore import pyqtSignal # PySide用户请替换为from PySide6.QtCore import Signal

class YourMainWindow(QObject):
    # 定义带字符串参数的信号，用于传递串口收到的内容
    new_serial_data = pyqtSignal(str) # PySide用户请替换为Signal(str)

    def __init__(self):
        super().__init__()
        # 绑定信号和UI更新槽函数
        self.new_serial_data.connect(self.writeTerminal)
        # 其余初始化逻辑...

2. 修改子线程逻辑，不直接调用UI方法，改为发送信号

子线程只负责读取串口数据，通过发送信号把数据传递给主线程：

def readPort_thread(self):
    while self.printerOnline == True:
        # 加errors='ignore'避免非UTF8字符导致解码崩溃
        recv_content = str(self.ser.readline(),'utf-8', errors='ignore')
        # 发送信号，将数据传递到主线程
        self.new_serial_data.emit(recv_content)

3. （可选优化）提升UI更新性能

原写法每次都要读取全量文本再拼接重写，数据量大时卡顿严重，可替换为更高效的appendPlainText方法：

def writeTerminal(self,inputTxt):
    # 可选：过滤空字符串避免无效空行
    if not inputTxt.strip():
        return
    if not inputTxt.endswith('\n'):
        inputTxt = inputTxt + '\n'
    # appendPlainText性能远高于拼接全量文本后setPlainText
    self.textG.appendPlainText(inputTxt)
    # 自动滚动到底部
    self.textG.verticalScrollBar().setValue(self.textG.verticalScrollBar().maximum())

额外注意事项 #

• 若串口数据流量极高，可增加简单的缓存逻辑批量更新UI，避免高频触发UI重绘导致卡顿
• 线程退出时请合理修改self.printerOnline状态，避免出现僵死线程

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