QGraphicsTextItem处理长段落卡顿，求优化解决方案

算力阿峰

2026-6-27

问题描述

我尝试使用Qt开发一款简易文本编辑器，因QGraphicsScene相比QTextEdit、QTextBrowser等具备更多功能，故选择基于它进行开发。以下是示例代码：

#include <QApplication>
#include <QWidget>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QGraphicsView view;
    QGraphicsScene *scene = new QGraphicsScene;
    QGraphicsTextItem *text = new QGraphicsTextItem;

    text->setTextWidth(1020);
    text->setTextInteractionFlags(Qt::TextEditorInteraction);
    text->setFocus();

    scene->addItem(text);

    view.setScene(scene);
    view.show();

    return app.exec();
}

该程序处理包含多段落、不同样式的格式化文本时运行良好，但输入单段长文本（约200k字符）时就会出现卡顿，而这一字符量远无法满足需求。推测是因为Qt会在内部拆分复杂文本，但不会拆分同样式的纯文本。已尝试多种优化QGraphicsScene的方法，但均无效果，恳请告知可行的解决方案。

解决方案

针对单段长文本在QGraphicsTextItem中卡顿的问题，可尝试以下几种方案：

手动拆分长文本为多个QGraphicsTextItem
Qt对单段同样式纯文本不会自动拆分，导致单个Item承载过多字符，渲染和编辑时性能下降。可以手动将长文本按固定字符数或行数拆分为多个QGraphicsTextItem，每个Item仅处理一部分内容：

QString longText = "你的超长单段文本";
const int chunkCharCount = 1500; // 每个Item承载的字符数，可根据实际调整
qreal yPos = 0;

for (int i = 0; i < longText.size(); i += chunkCharCount) {
    QString chunk = longText.mid(i, chunkCharCount);
    QGraphicsTextItem *textItem = new QGraphicsTextItem(chunk);
    textItem->setTextWidth(1020);
    textItem->setTextInteractionFlags(Qt::TextEditorInteraction);
    textItem->setPos(0, yPos);
    scene->addItem(textItem);
    
    // 更新下一个Item的Y坐标
    yPos += textItem->boundingRect().height();
}

同时需要处理编辑时的光标连续逻辑：监听每个Item的光标位置，当光标到达当前Item末尾时，自动将焦点切换到下一个Item；同理，光标到达开头时切换到上一个Item。可通过重写QGraphicsTextItem的keyPressEvent实现该逻辑。

重写QGraphicsTextItem的绘制逻辑，只渲染可见区域
默认情况下QGraphicsTextItem会绘制全部文本，即使大部分内容不在视图可见范围内。重写paint方法，结合QGraphicsView的可见区域，仅绘制需要显示的文本段落：

class OptimizedTextItem : public QGraphicsTextItem
{
protected:
    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override
    {
        QGraphicsView *view = scene()->views().first();
        if (!view) {
            QGraphicsTextItem::paint(painter, option, widget);
            return;
        }
        
        // 获取视图可见区域在Scene中的坐标
        QRectF visibleRect = view->mapToScene(view->viewport()->rect()).boundingRect();
        // 计算当前Item中需要绘制的文本范围
        QTextLayout *layout = document()->documentLayout()->layout();
        int startLine = layout->lineForPosition(visibleRect.topLeft()).lineNumber();
        int endLine = layout->lineForPosition(visibleRect.bottomRight()).lineNumber();
        
        // 只绘制可见范围内的行
        painter->save();
        for (int i = startLine; i <= endLine; ++i) {
            QTextLine line = layout->lineAt(i);
            line.draw(painter, QPointF(0, line.y()));
        }
        painter->restore();
    }
};

该方法能大幅减少不必要的绘制操作，提升长文本的滚动和编辑流畅度。

使用QTextLayout手动管理文本布局
绕过QGraphicsTextItem的默认实现，直接用QTextLayout拆分长文本为多个布局块，每个布局块对应一部分文本，然后在自定义QGraphicsItem中绘制这些布局块。这种方式能更精细地控制文本的渲染和更新，比如只重新渲染修改过的布局块，而非整个文本。
结合QPlainTextEdit的优化逻辑
如果必须保留QGraphicsScene的功能，可将QPlainTextEdit的视图作为QGraphicsProxyWidget加入Scene：
```
QPlainTextEdit *plainTextEdit = new QPlainTextEdit;
plainTextEdit->setPlainText(longText);
QGraphicsProxyWidget *proxy = scene()->addWidget(plainTextEdit);
proxy->setPos(0, 0);
```
QPlainTextEdit专门针对长文本做了性能优化，比如只渲染可见行、延迟加载等，能有效解决卡顿问题，同时借助QGraphicsProxyWidget融入Scene的生态。

启用QGraphicsView的高级优化选项
确保开启以下优化（即使你之前尝试过，可再次确认配置）：

view.setOptimizationFlags(QGraphicsView::DontSavePainterState | QGraphicsView::DontAdjustForAntialiasing);
view.setViewportUpdateMode(QGraphicsView::MinimalViewportUpdate);
view.setCacheMode(QGraphicsView::CacheBackground);

这些选项能减少视图渲染时的开销，提升整体性能。

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