PyQt进阶技巧：QTextEdit的富文本处理与滚动条动态控制-CSDN博客

1. 不只是文本框：QTextEdit的富文本与滚动条控制实战

很多刚开始用PyQt做界面的朋友，会把QTextEdit当成一个“高级点的文本框”。确实，你可以用它来输入文字，获取文字，这跟QLineEdit好像差不多，只是能多写几行。但如果你只这么用，那可真是大材小用了，相当于用一台高性能游戏本只来写文档。我做了这么多年桌面应用开发，QTextEdit是我处理文本展示和编辑时最得力的工具之一，尤其是在需要富文本（HTML） 和动态滚动条的场景下，它的能力远超你的想象。

举个例子，我做过一个实时日志监控系统。后台服务不停地吐日志，有普通信息（黑色）、警告（黄色）、错误（红色），需要在前端界面里实时、清晰地展示出来。如果用纯文本，所有信息混在一起，关键错误一眼找不到，用户体验很差。这时候，QTextEdit的富文本能力就派上用场了，我可以轻松地把不同级别的日志渲染成不同的颜色和样式。更妙的是，当用户正在查看某条历史日志时，我不希望新日志的涌入把滚动条突然顶上去，打断他的阅读；而当用户将滚动条拉到底部时，我又希望新日志能自动追尾显示。这就需要动态控制滚动条的策略。另一个常见的场景是开发一个简易的富文本编辑器，用户输入**加粗**或*斜体*的Markdown标记，你需要实时将其转换为对应的HTML并在QTextEdit中渲染，同时还要处理好光标位置和文本的自动滚动，让编辑体验流畅自然。

所以，今天我们就深入聊聊QTextEdit的两大进阶技巧：富文本（HTML）的处理与滚动条的动态控制。我会用大量我实际踩过坑的代码示例，带你从“会用”到“精通”，让你在开发类似日志系统、聊天窗口、代码编辑器、富文本笔记应用时，能更加得心应手。

2. 富文本（HTML）处理：从渲染到编辑的完整链条

2.1 setText() vs setPlainText()：不只是显示区别

原始文章提到了setText()和setPlainText()的区别，这确实是理解QTextEdit富文本能力的起点。但我想更深入地聊聊，它们背后的机制和实际应用中的“坑”。

setPlainText()很简单，它就是设置纯文本。你给它什么字符串，它就原封不动地显示出来，包括<b>这类HTML标签也会被当成普通字符显示。它的内部处理效率很高，因为不需要解析。

而setText()则是一个“小浏览器”。当你传入一个字符串时，QTextEdit会尝试把它当作HTML来解析和渲染。这意味着你可以嵌入丰富的样式。但这里有个关键点：QTextEdit支持的HTML是Qt自己实现的一个子集，并非所有现代HTML/CSS特性都支持。它主要支持一些基本的标签，比如字体、颜色、加粗、斜体、下划线、列表、表格等。对于复杂的CSS3样式或JavaScript，它是无能为力的。

我写个更丰富的例子你感受一下：

from PyQt5.QtWidgets import QApplication, QTextEdit, QVBoxLayout, QWidget
import sys

class RichTextDemo(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle('富文本展示示例')
        layout = QVBoxLayout()

        self.text_edit = QTextEdit()
        # 使用setText()设置富文本HTML
        html_content = """
        <h3 style='color: blue;'>这是一个带样式的标题</h3>
        <p>这是普通段落。</p>
        <p><b>这是加粗的文字</b>，<i>这是斜体的文字</i>，<u>这是带下划线的文字</u>。</p>
        <p>字体颜色：<span style='color: red;'>红色</span>，<span style='color: green;'>绿色</span>。</p>
        <p>字体大小：<span style='font-size: 18pt;'>大号字</span>，<span style='font-size: 10pt;'>小号字</span>。</p>
        <ul>
            <li>无序列表项1</li>
            <li>无序列表项2</li>
        </ul>
        <ol>
            <li>有序列表项1</li>
            <li>有序列表项2</li>
        </ol>
        <table border='1' style='border-collapse: collapse;'>
            <tr><th>姓名</th><th>年龄</th></tr>
            <tr><td>张三</td><td>25</td></tr>
            <tr><td>李四</td><td>30</td></tr>
        </table>
        """
        self.text_edit.setText(html_content)

        layout.addWidget(self.text_edit)
        self.setLayout(layout)
        self.resize(500, 400)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = RichTextDemo()
    ex.show()
    sys.exit(app.exec_())

运行这段代码，你会看到一个渲染了标题、彩色文字、列表和简单表格的文本框。这就是setText()的基础能力。但请注意，表格的边框样式border-collapse可能不被完全支持，实际显示效果会和网页略有差异。在实际项目中，我通常先用简单的HTML测试一下目标样式是否被支持。

2.2 动态混合富文本与纯文本：光标操作的艺术

仅仅静态设置HTML还不够，更多时候我们需要动态地、片段化地插入带格式的文本。比如在日志系统中，错误信息来了就插入一段红色文字。这时候就不能再用setText()覆盖全部内容了，而是要用到光标（QTextCursor） 来在指定位置插入。

原始文章给出了一个光标插入红色文本的例子，我在此基础上扩展一个更贴近实战的场景：模拟一个实时日志系统，不同级别日志用不同格式插入。

from PyQt5.QtWidgets import *
from PyQt5.QtCore import Qt, QTimer
from PyQt5.QtGui import QTextCharFormat, QFont, QColor
import sys
import random
import datetime

class LogViewer(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()