PyQt5 QTextEdit新增行自定义文本颜色与高亮效果实现方法咨询

QTextEdit 支持3种常用的文本着色方案，可按需选择：

1. 富文本HTML直接插入（改动最小，适配现有append用法） #

QTextEdit原生支持解析HTML标签，你不需要修改现有的追加逻辑，仅需把要插入的文本用带样式的span标签包裹即可，实现难度最低。

• 示例用法：

# 普通信息（黑色）
self.main_window.textEdit.append(f'<span style="color:black;">{get_proj}</span>')
# 错误信息（红色）
self.main_window.textEdit.append(f'<span style="color:red;">{get_proj}</span>')
# 警告信息（黄色）
self.main_window.textEdit.append(f'<span style="color:orange;">{get_proj}</span>')
# 带红色高亮效果的文本
self.main_window.textEdit.append(f'<span style="background-color:#ffb3b3;color:black;">{get_proj}</span>')

• 适用场景：仅需要逐行追加时自定义颜色/高亮，不需要修改已有文本格式的场景。

2. QTextCharFormat 字符格式控制（灵活性最高） #

通过操作QTextCursor和QTextCharFormat可以精准控制每段文本的样式，除了颜色、高亮外还支持设置字体、字号、下划线等更多格式。

• 示例封装方法：

from PyQt5.QtGui import QTextCharFormat, QBrush, QColor

def append_colored_text(text_edit, text, text_color=QColor(0,0,0), highlight_color=None):
    cursor = text_edit.textCursor()
    cursor.movePosition(cursor.End)
    # 定义文本格式
    text_format = QTextCharFormat()
    text_format.setForeground(QBrush(text_color))
    if highlight_color:
        text_format.setBackground(QBrush(highlight_color))
    # 插入文本
    cursor.insertText(text, text_format)
    # 自动滚动到最底部
    text_edit.setTextCursor(cursor)
    text_edit.ensureCursorVisible()

# 调用示例：追加红色错误信息
append_colored_text(self.main_window.textEdit, get_proj, text_color=QColor(255,0,0))
# 调用示例：追加带红色高亮的普通文本
append_colored_text(self.main_window.textEdit, get_proj, highlight_color=QColor(255,179,179))

• 适用场景：需要复杂格式控制、后续可能要修改已有文本样式的场景。

3. QSyntaxHighlighter 语法高亮（规则化自动着色） #

如果你需要对已存在的文本按照固定规则自动着色（比如匹配所有"错误"关键词自动标红、所有"警告"关键词自动标黄），可以继承QSyntaxHighlighter实现规则化高亮。

• 示例实现：

from PyQt5.QtGui import QSyntaxHighlighter, QTextCharFormat, QColor

class LogHighlighter(QSyntaxHighlighter):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 定义规则：匹配错误行标红
        self.error_format = QTextCharFormat()
        self.error_format.setForeground(QColor(255,0,0))
        # 定义规则：匹配警告行标黄
        self.warning_format = QTextCharFormat()
        self.warning_format.setForeground(QColor(255,165,0))
        # 匹配规则可自定义正则表达式
        self.rules = [
            (r'^错误.*', self.error_format),
            (r'^警告.*', self.warning_format)
        ]
    
    def highlightBlock(self, text):
        for pattern, format in self.rules:
            import re
            match_iter = re.finditer(pattern, text)
            for match in match_iter:
                self.setFormat(match.start(), match.end() - match.start(), format)

# 绑定到QTextEdit
self.highlighter = LogHighlighter(self.main_window.textEdit.document())

• 适用场景：需要按照固定规则对全文本自动着色的场景。

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