PySide6双QTextEdit大量内容时滚动同步精度问题求助

问题背景 #

我开发了一款基于PySide6的应用，包含两个QTextEdit组件，需求是让这两个QTextEdit实现滚动同步。当前使用以下代码实现该功能：

self.scrollconnect1 = self.TextEdit_1.verticalScrollBar().valueChanged.connect(
    self.TextEdit_2.verticalScrollBar().setValue)
self.scrollconnect2 = self.TextEdit_2.verticalScrollBar().valueChanged.connect(
    self.TextEdit_1.verticalScrollBar().setValue)

该代码在QTextEdit内容行数较少时运行正常，但当两个组件均包含约50000行内容时，尤其在同时使用鼠标滚轮和滚动条操作时，无法精准同步到同一行。

问题分析 #

直接连接valueChanged信号会引发循环触发问题：当A滚动条的信号触发B滚动条更新时，B的valueChanged又会反向触发A更新，大量内容下这种循环会导致数值延迟或偏差。此外，单纯同步滚动条绝对数值没有考虑文本渲染的比例关系，容易因为内容高度差异出现错位。

优化解决方案 #

核心思路是阻止循环信号触发，并基于滚动比例而非绝对数值同步，确保大量内容下的精准性。以下是完整实现代码：

from PySide6 import QtCore, QtGui, QtWidgets

class Window(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.editTop = QtWidgets.QPlainTextEdit()
        self.editBtm = QtWidgets.QPlainTextEdit()
        
        # 标记同步状态，防止循环触发
        self._is_syncing = False
        
        # 连接滚动条数值变化信号到同步函数
        self.editTop.verticalScrollBar().valueChanged.connect(
            lambda val: self.sync_scroll(self.editTop, self.editBtm, val)
        )
        self.editBtm.verticalScrollBar().valueChanged.connect(
            lambda val: self.sync_scroll(self.editBtm, self.editTop, val)
        )
        
        # 连接滚动动作触发信号，同步拖动、按键等操作
        self.editTop.verticalScrollBar().actionTriggered.connect(
            lambda act: self.sync_scroll_action(self.editTop, self.editBtm, act)
        )
        self.editBtm.verticalScrollBar().actionTriggered.connect(
            lambda act: self.sync_scroll_action(self.editBtm, self.editTop, act)
        )
        
        layout = QtWidgets.QVBoxLayout(self)
        layout.addWidget(self.editTop)
        layout.addWidget(self.editBtm)
        
        # 填充50000行测试内容
        line = ' text' * 40
        for index in range(50000):
            self.editTop.insertPlainText(f"\n{index}{line}")
            self.editBtm.insertPlainText(f"\n{index}{line}")

    def sync_scroll(self, source_edit, target_edit, value):
        if self._is_syncing:
            return
        
        self._is_syncing = True
        source_scroll = source_edit.verticalScrollBar()
        target_scroll = target_edit.verticalScrollBar()
        
        # 基于滚动比例同步，适配内容高度差异
        source_max = source_scroll.maximum()
        target_max = target_scroll.maximum()
        
        if source_max == 0 or target_max == 0:
            target_scroll.setValue(0)
        else:
            ratio = value / source_max
            target_value = int(ratio * target_max)
            target_scroll.setValue(target_value)
        
        self._is_syncing = False

    def sync_scroll_action(self, source_edit, target_edit, action):
        if self._is_syncing:
            return
        
        self._is_syncing = True
        target_edit.verticalScrollBar().triggerAction(
            QtWidgets.QAbstractSlider.SliderAction(action)
        )
        self._is_syncing = False

if __name__ == '__main__':
    app = QtWidgets.QApplication(['Test'])
    window = Window()
    window.setGeometry(800, 100, 600, 400)
    window.show()
    app.exec()

关键改进点 #

• 循环触发防护：通过_is_syncing标志位，在同步过程中忽略反向信号，彻底避免无限循环导致的延迟。
• 比例同步逻辑：计算滚动位置占总滚动范围的比例，再将该比例映射到目标组件，即使两个组件内容高度存在细微差异，也能保持相对滚动位置一致。
• 全操作同步：额外处理actionTriggered信号，同步滚动条的拖动、按页滚动、按键滚动等所有操作类型，保证操作体验一致。

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