如何在PyQt的QTextEdit中实现打字机文本显示效果？

你之前代码的问题 #

• 第一个QThread写法：循环和sleep都在主线程执行，直接阻塞了UI事件循环，导致程序无响应。而且Qt禁止在非主线程直接操作UI控件，就算把循环放到子线程，直接修改QTextEdit也会引发崩溃。
• 第二个Timer写法：用while循环等待timer结束，同样会阻塞主线程，UI没法处理刷新和用户操作，自然卡死。

方案一：使用QTimer实现（推荐，更简洁） #

这种方式不需要额外线程，利用Qt的事件循环处理定时任务，不会阻塞UI。

from PyQt5 import QtWidgets, QtCore, QtGui

class MyWindow(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.text_edit = QtWidgets.QTextEdit(self)
        self.layout = QtWidgets.QVBoxLayout(self)
        self.layout.addWidget(self.text_edit)
        
        # 初始化打字机相关变量
        self.display_string = "This is the sentence I want to display."
        self.current_char_index = 0
        self.type_timer = QtCore.QTimer(self)
        self.type_timer.timeout.connect(self.append_next_char)
        
        # 绑定鼠标点击事件
        self.text_edit.mousePressEvent = self.on_mouse_click

    def on_mouse_click(self, event):
        # 点击后重置状态并启动定时器
        self.current_char_index = 0
        self.text_edit.clear()  # 可选：清空之前的内容
        self.type_timer.start(1000)  # 每隔1秒触发一次

    def append_next_char(self):
        if self.current_char_index < len(self.display_string):
            char = self.display_string[self.current_char_index]
            self.text_edit.moveCursor(QtGui.QTextCursor.End)
            self.text_edit.insertPlainText(char)  # 用insertPlainText避免自动换行
            self.current_char_index += 1
        else:
            self.type_timer.stop()  # 字符全部显示完毕，停止定时器

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

方案二：使用QThread+信号槽实现 #

如果需要把计时逻辑放到子线程（比如后续有复杂耗时操作），可以用这种方式，子线程只负责发送信号，主线程处理UI更新。

from PyQt5 import QtWidgets, QtCore, QtGui

# 定义子线程类
class TypeThread(QtCore.QThread):
    # 定义信号，传递要显示的字符
    send_char = QtCore.pyqtSignal(str)
    
    def __init__(self, display_string):
        super().__init__()
        self.display_string = display_string
        self.is_running = False

    def run(self):
        self.is_running = True
        for char in self.display_string:
            if not self.is_running:
                break
            self.send_char.emit(char)
            self.sleep(1)  # 子线程里sleep不会阻塞主线程
        self.is_running = False

class MyWindow(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.text_edit = QtWidgets.QTextEdit(self)
        self.layout = QtWidgets.QVBoxLayout(self)
        self.layout.addWidget(self.text_edit)
        
        self.display_string = "This is the sentence I want to display."
        self.type_thread = None
        
        # 绑定鼠标点击事件
        self.text_edit.mousePressEvent = self.on_mouse_click

    def on_mouse_click(self, event):
        # 如果线程正在运行，先停止并清理
        if self.type_thread and self.type_thread.is_running:
            self.type_thread.is_running = False
            self.type_thread.wait()
        
        # 清空内容，初始化线程
        self.text_edit.clear()
        self.type_thread = TypeThread(self.display_string)
        self.type_thread.send_char.connect(self.append_char)
        self.type_thread.finished.connect(self.type_thread.deleteLater)  # 线程结束后自动清理
        self.type_thread.start()

    def append_char(self, char):
        self.text_edit.moveCursor(QtGui.QTextCursor.End)
        self.text_edit.insertPlainText(char)

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

关键注意事项 #

• 操作UI控件必须在主线程，子线程只能通过信号槽通知主线程更新UI。
• 绝对不能用while循环阻塞主线程，Qt的事件循环需要持续运行才能处理UI刷新和用户操作。
• 优先用insertPlainText代替append，因为append会自动添加换行符，破坏连续打字的效果。

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