fix(editor): enhance cursor update handling and performance

- Introduced deferred cursor update mechanism to optimize performance during text insertion and deletion.
- Added methods to manage cursor updates more efficiently, reducing unnecessary updates when typing.
- Improved left area widget refresh logic to only update when the number of lines changes.

bug: https://pms.uniontech.com/bug-view-368159.html

Log: 优化光标更新处理，提升编辑器性能和响应速度。

Author: dengzhongyuan365-dev

src/editor/dtextedit.cpp

@@ -109,10 +109,16 @@ TextEdit::TextEdit(QWidget *parent)
     // Init widgets.
     //左边栏控件　滑动条滚动跟新行号 折叠标记
     connect(this->verticalScrollBar(), &QScrollBar::valueChanged, this, &TextEdit::slotValueChanged);
-    connect(this, &QPlainTextEdit::textChanged, this, &TextEdit::updateLeftAreaWidget);
     connect(this, &QPlainTextEdit::textChanged, this, [this]() {
-        if (this->m_wrapper)
-            this->m_wrapper->UpdateBottomBarWordCnt(this->characterCount());
+        if (m_wrapper) {
+            m_wrapper->UpdateBottomBarWordCnt(characterCount());
+        }
+        // 仅行数变化时全量刷新左侧栏；同行编辑由 cursorPositionChanged 局部 update 负责
+        const int blockCountNow = blockCount();
+        if (blockCountNow != m_lastLeftAreaBlockCount) {
+            m_lastLeftAreaBlockCount = blockCountNow;
+            updateLeftAreaWidget();
+        }
     });
 
     connect(this, &QPlainTextEdit::cursorPositionChanged, this, &TextEdit::cursorPositionChanged);
@@ -164,6 +170,11 @@ TextEdit::TextEdit(QWidget *parent)
     m_scrollAnimation->setEasingCurve(QEasingCurve::InOutExpo);
     m_scrollAnimation->setDuration(300);
 
+    m_typingBurstFlushTimer = new QTimer(this);
+    m_typingBurstFlushTimer->setSingleShot(true);
+    m_typingBurstFlushTimer->setInterval(120);
+    connect(m_typingBurstFlushTimer, &QTimer::timeout, this, &TextEdit::flushDeferredCursorUpdate);
+
     m_cursorMode = Insert;
 
     connect(m_scrollAnimation, &QPropertyAnimation::finished, this, &TextEdit::handleScrollFinish, Qt::QueuedConnection);
@@ -298,6 +309,7 @@ void TextEdit::deleteSelectTextEx(QTextCursor cursor, QString text, bool currLin
 void TextEdit::deleteTextEx(QTextCursor cursor)
 {
     qDebug() << "Deleting text at position:" << cursor.position();
+    flushDeferredCursorUpdate();
     QUndoCommand *pDeleteStack = new DeleteTextUndoCommand(cursor, this);
     m_pUndoStack->push(pDeleteStack);
     qDebug() << "Text deleted successfully";
@@ -328,15 +340,32 @@ void TextEdit::deleteMultiTextEx(const QList<QTextCursor> &multiText)
 void TextEdit::insertSelectTextEx(QTextCursor cursor, QString text)
 {
     qDebug() << "Inserting selected text at position:" << cursor.position() << "Length:" << text.length();
+
+    const bool deferHeavyUpdate = shouldDeferCursorHeavyUpdate(cursor, text);
+    if (!deferHeavyUpdate) {
+        flushDeferredCursorUpdate();
+    } else {
+        const int line = cursor.blockNumber();
+        if (m_deferCursorHeavyUpdate && line != m_deferCursorLastLine) {
+            flushDeferredCursorUpdate();
+        }
+        m_deferCursorHeavyUpdate = true;
+        m_deferCursorLastLine = line;
+    }
+
     QUndoCommand *pInsertStack = new InsertTextUndoCommand(cursor, text, this);
     m_pUndoStack->push(pInsertStack);
     ensureCursorVisible();
+    if (deferHeavyUpdate) {
+        scheduleDeferredCursorUpdateBurst();
+    }
     qDebug() << "Selected text inserted successfully";
 }
 
 void TextEdit::insertColumnEditTextEx(QString text)
 {
     qDebug() << "Inserting column text";
+    flushDeferredCursorUpdate();
     if (m_isSelectAll) {
         QPlainTextEdit::selectAll();
     }
@@ -2987,7 +3016,63 @@ bool TextEdit::setCursorKeywordSeletoin(int position, bool findNext)
     return false;
 }
 
-void TextEdit::cursorPositionChanged()
+bool TextEdit::shouldDeferCursorHeavyUpdate(const QTextCursor &cursor, const QString &text) const
+{
+    if (m_cursorMode != Insert
+            || m_bIsAltMod
+            || m_readOnlyMode
+            || m_bReadOnlyPermission
+            || m_bIsFileOpen
+            || m_isPreeditBefore
+            || m_bIsInputMethod) {
+        return false;
+    }
+
+    if (cursor.anchor() != cursor.position()) {
+        return false;
+    }
+
+    for (const QChar ch : text) {
+        if (ch == QLatin1Char('\n') || ch == QLatin1Char('\t') || ch == QChar::ParagraphSeparator) {
+            return false;
+        }
+    }
+
+    return true;
+}
+
+void TextEdit::scheduleDeferredCursorUpdateBurst()
+{
+    m_deferCursorHeavyUpdate = true;
+    m_deferCursorLastLine = textCursor().blockNumber();
+    m_typingBurstFlushTimer->start();
+}
+
+void TextEdit::flushDeferredCursorUpdate()
+{
+    if (m_typingBurstFlushTimer != nullptr) {
+        m_typingBurstFlushTimer->stop();
+    }
+
+    if (!m_deferCursorHeavyUpdate) {
+        return;
+    }
+
+    m_deferCursorHeavyUpdate = false;
+    m_deferCursorLastLine = -1;
+    applyCursorHeavyUpdate();
+}
+
+void TextEdit::updateCursorPositionStatusLightweight()
+{
+    QTextCursor cursor = textCursor();
+    if (m_wrapper) {
+        m_wrapper->bottomBar()->updatePosition(cursor.blockNumber() + 1,
+                                               cursor.positionInBlock() + 1);
+    }
+}
+
+void TextEdit::applyCursorHeavyUpdate()
 {
     qDebug() << "Cursor position changed";
     // 以赋值形式，清空 Bracket 括号的selection
@@ -3001,19 +3086,30 @@ void TextEdit::cursorPositionChanged()
     updateHighlightBrackets('[', ']');
     renderAllSelections();
 
-    QTextCursor cursor = textCursor();
-    if (m_wrapper) {
-        qDebug() << "Cursor position changed with wrapper";
-        m_wrapper->bottomBar()->updatePosition(cursor.blockNumber() + 1,
-                                               cursor.positionInBlock() + 1);
-    }
+    updateCursorPositionStatusLightweight();
 
     m_pLeftAreaWidget->m_pLineNumberArea->update();
     m_pLeftAreaWidget->m_pBookMarkArea->update();
     m_pLeftAreaWidget->m_pFlodArea->update();
     qDebug() << "Cursor position changed completed";
 }
 
+void TextEdit::cursorPositionChanged()
+{
+    if (m_deferCursorHeavyUpdate) {
+        const int line = textCursor().blockNumber();
+        if (line != m_deferCursorLastLine) {
+            flushDeferredCursorUpdate();
+            return;
+        }
+
+        updateCursorPositionStatusLightweight();
+        return;
+    }
+
+    applyCursorHeavyUpdate();
+}
+
 /**
  * @brief 剪切光标选中的文本
  * @param ignoreCheck 是否忽略权限判断(外部已进行)，默认false
@@ -3539,6 +3635,7 @@ void TextEdit::slotRedoAvailable(bool redoIsAvailable)
 void TextEdit::redo_()
 {
     qDebug() << "Starting redo operation";
+    flushDeferredCursorUpdate();
     if (!m_pUndoStack->canRedo()) {
         qDebug() << "Redo operation skipped - nothing to redo";
         return;
@@ -3570,6 +3667,7 @@ void TextEdit::undo_()
 {
     qDebug() << "Starting undo operation";
     qDebug() << "Starting undo operation";
+    flushDeferredCursorUpdate();
     if (!m_pUndoStack->canUndo()) {
         qDebug() << "Undo operation skipped - nothing to undo";
         return;
@@ -5495,6 +5593,7 @@ void TextEdit::setTextFinished()
     qDebug() << "Set text finished";
     m_bIsFileOpen = false;
     m_nLines = blockCount();
+    m_lastLeftAreaBlockCount = m_nLines;
 
     if (!m_listBookmark.isEmpty()) {
         qDebug() << "Set text finished, m_listBookmark is not empty";
@@ -6563,6 +6662,13 @@ void TextEdit::updateMark(int from, int charsRemoved, int charsAdded)
         return;
     }
 
+    // 无任何颜色/关键字标记时无需处理；渲染由 cursorPositionChanged 统一负责
+    if (m_wordMarkSelections.isEmpty()
+            && m_mapKeywordMarkSelections.isEmpty()
+            && m_mapWordMarkSelections.isEmpty()) {
+        return;
+    }
+
     qDebug() << "updateMark, charsRemoved" << charsRemoved << "charsAdded" << charsAdded;
     //更新标记
     int nStartPos = 0,///< 标记的起始位置
@@ -7604,6 +7710,7 @@ void TextEdit::dropEvent(QDropEvent *event)
 
 void TextEdit::inputMethodEvent(QInputMethodEvent *e)
 {
+    flushDeferredCursorUpdate();
     m_bIsInputMethod = true;
 
     if (m_isSelectAll)
@@ -7674,6 +7781,7 @@ void TextEdit::inputMethodEvent(QInputMethodEvent *e)
 
 void TextEdit::mousePressEvent(QMouseEvent *e)
 {
+    flushDeferredCursorUpdate();
     if (m_bIsFindClose)
     {
         m_bIsFindClose = false;
@@ -8193,6 +8301,7 @@ void TextEdit::keyPressEvent(QKeyEvent *e)
 
         //列编辑 删除撤销重做
         if (modifiers == Qt::NoModifier && (e->key() == Qt::Key_Backspace)) {
+            flushDeferredCursorUpdate();
             if (m_isSelectAll)
                 QPlainTextEdit::selectAll();
 
@@ -8216,6 +8325,7 @@ void TextEdit::keyPressEvent(QKeyEvent *e)
 
         //列编辑 向后删除撤销重做
         if (modifiers == Qt::NoModifier && (e->key() == Qt::Key_Delete)) {
+            flushDeferredCursorUpdate();
             if (m_isSelectAll)
                 QPlainTextEdit::selectAll();
 

src/editor/dtextedit.h

@@ -27,6 +27,7 @@
 #include <DPlainTextEdit>
 #include <QLineEdit>
 #include <QPropertyAnimation>
+#include <QTimer>
 #include <QFont>
 #include <DGuiApplicationHelper>
 #include <QtDBus>
@@ -510,6 +511,9 @@ public slots:
     void onSelectionArea();
     void fingerZoom(QString name, QString direction, int fingers);
     void cursorPositionChanged();
+    void flushDeferredCursorUpdate();
+    void applyCursorHeavyUpdate();
+    void updateCursorPositionStatusLightweight();
 
     //剪切槽函数
     void cut(bool ignoreCheck = false);
@@ -784,6 +788,7 @@ private slots:
     QList<int> m_listBookmark;///< 存储书签的list
     int m_nBookMarkHoverLine;///< 悬浮效果书签所在的行
     int m_nLines;///< 文本总行数
+    int m_lastLeftAreaBlockCount = 0;///< 上次刷新左侧栏时的文档行数
     bool m_bIsFileOpen;///< 是否在读取文件（导致文本变化）
     bool m_bIsShortCut;///< 是否在使用书签快捷键
 
@@ -872,6 +877,13 @@ private slots:
     bool m_isPreeditBefore = false;     // 上一个输入法时间是否是 preedit
     int m_preeditLengthBefore = 0;
 
+    bool shouldDeferCursorHeavyUpdate(const QTextCursor &cursor, const QString &text) const;
+    void scheduleDeferredCursorUpdateBurst();
+
+    bool m_deferCursorHeavyUpdate = false;
+    int m_deferCursorLastLine = -1;
+    QTimer *m_typingBurstFlushTimer = nullptr;
+
     Qt::CaseSensitivity defaultCaseSensitive = Qt::CaseInsensitive; // 查找匹配时默认不区分大小写
 };
 #endif