PySide6 QPlainTextEdit字符显示不全问题求助

问题根源 #

你遇到的字符显示异常（部分字符不显示、延迟显示），核心原因是跨线程直接操作GUI控件：工作线程（QRunnable）中调用的日志函数，直接触发了QPlainTextEdit.appendPlainText()，而Qt要求所有GUI操作必须在主线程执行，跨线程操作会导致控件绘制逻辑混乱。

解决方案：用信号槽实现线程安全的日志更新 #

Qt的信号槽机制天然支持跨线程通信，会自动将信号发送的任务排队到主线程执行，完全符合GUI线程安全要求。

1. 修改日志处理器QtLogHandler，改用信号触发更新 #

from PySide6.QtCore import QObject, Slot, Signal

class QtLogHandler(logging.Handler, QObject):
    # 定义传递日志内容的信号
    log_signal = Signal(str)

    def __init__(self, widget):
        logging.Handler.__init__(self)
        QObject.__init__(self)
        self.widget = widget
        # 绑定信号到主线程的更新槽
        self.log_signal.connect(self._append_log_safely)

    def emit(self, record):
        msg = self.format(record)
        # 发送信号，而非直接操作控件
        self.log_signal.emit(msg)

    @Slot(str)
    def _append_log_safely(self, msg):
        # 此方法在主线程执行，可安全操作GUI
        self.widget.appendPlainText(msg)
        self.widget.ensureCursorVisible()
        # 可选：强制刷新控件（如果仍有显示问题）
        # self.widget.repaint()

2. 修改MainWindow的日志添加方法，同样用信号保证线程安全 #

class MainWindow(QMainWindow):
    # 定义添加日志的信号
    add_log_signal = Signal(str)

    def __init__(self):
        super(MainWindow, self).__init__()
        # ... 原有初始化代码
        # 绑定信号到安全更新槽
        self.add_log_signal.connect(self._safe_add_log)

    def _safe_add_log(self, message):
        # 主线程安全更新控件
        self.logger_handler.widget.appendPlainText(message)
        self.logger_handler.widget.ensureCursorVisible()

    def add_log_message(self, message):
        # 通过信号发送日志，避免直接在非主线程操作GUI
        self.add_log_signal.emit(message)

3. 验证线程边界 #

确保所有调用log()或add_log_message()的地方，无论是工作线程还是主线程，都通过信号槽间接操作QPlainTextEdit，彻底避免跨线程GUI操作。

额外注意事项 #

• 不要在非主线程中调用任何QWidget的方法，包括但不限于appendPlainText()、setText()、ensureCursorVisible()。
• QProcess的readyReadStandardOutput和readyReadStandardError槽函数本身就在主线程执行，handle_stdout/handle_stderr可直接调用_safe_add_log，用信号统一管理更规范。

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