PyQt5中QTextEdit控件如何追踪文本框具体变更内容

PyQt5 没有提供直接返回本次文本变更具体内容的开箱即用接口，但完全不需要自行实现全量文本差异比对逻辑。QTextEdit 底层绑定的 QTextDocument 会在每次内容变更时抛出携带精确修改位置、修改长度的信号，基于该信号可以直接定位到增删内容，性能远高于全量diff方案。

你当前使用的 textChanged 信号只会在文本修改完成后触发，不携带任何本次修改的元信息，只能拿到修改后的全量文本，因此必须配合修改前的全量缓存做差异计算，长文本场景下效率很低。

不要监听 textChanged，改为监听 QTextDocument 提供的 contentsChange 信号，该信号触发时会携带3个整数参数：

• position：本次修改的起始字符下标
• charsRemoved：从起始位置开始，本次操作删除的字符长度
• charsAdded：从起始位置开始，本次操作新增的字符长度

注意该信号触发时，删除操作已经生效、新增内容已经写入文档，因此：

• 被删除的内容需要从修改前的文本缓存中，按给出的位置和长度截取
• 新增的内容可以直接从当前文档中，按给出的位置和长度截取

from PyQt5.QtWidgets import QApplication, QTextEdit
import sys

class LoggingTextEdit(QTextEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 初始化文本缓存
        self._content_cache = self.toPlainText()
        # 绑定底层文档的变更信号
        self.document().contentsChange.connect(self._track_change)

    def _track_change(self, pos: int, removed_len: int, added_len: int):
        # 提取变更内容
        removed_text = self._content_cache[pos: pos+removed_len] if removed_len else ""
        added_text = self.toPlainText()[pos: pos+added_len] if added_len else ""

        # 替换为你的日志记录逻辑
        print(f"位置{pos}：删除[{removed_text}]，新增[{added_text}]")

        # 更新缓存为最新内容
        self._content_cache = self.toPlainText()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    win = LoggingTextEdit()
    win.resize(600, 400)
    win.show()
    sys.exit(app.exec_())

• 上述实现在文本长度小于10万字的常规GUI场景下性能足够，没有额外开销。如果需要处理超大文本，可以自定义继承QTextDocument，在contentsChange信号发射前提前读取待删除片段，不需要维护全量文本缓存。
• 如果需要追踪字体、颜色、段落对齐这类不改变纯文本的格式修改，可以额外监听QTextDocument的charFormatChanged、blockFormatChanged信号，同样可以拿到格式变更的精确位置。
• 如果需要按用户操作粒度（一次连续输入/一次删除算一个操作）记录日志，可以结合控件的撤销栈QUndoStack的变更信号做聚合，避免逐字符记录日志过于细碎。

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