如何根据内容精确计算QTextEdit高度以消除垂直滚动条

原有实现的问题 #

之前的写法存在三个核心错误，导致高度计算不准：

1. 依赖QFontMetrics计算多行文本高度本身就存在偏差，它无法覆盖QTextEdit文档的边距、控件框架宽度等额外尺寸
2. 文档边距设置的顺序错误：先算尺寸再调用setDocumentMargin(0)，计算时用的还是默认边距下的参数
3. 没有补偿水平滚动条占用的高度：水平滚动条显示时会挤压内部文本视口的高度，不把这部分算进总高度就会逼出垂直滚动条

问题效果参考：

正确实现逻辑 #

不要自行通过字体度量计算尺寸，直接读取QTextDocument渲染完成后的真实高度，再叠加控件框架、滚动条的额外高度即可。

1. 首先永久禁用垂直滚动条，从根源上避免垂直滚动条出现：

   edit->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
   

2. 封装通用高度更新函数，初始化和内容变更时都调用该函数：

   void updateEditHeight(QTextEdit* edit)
   {
       // 先确保文档边距配置生效
       edit->document()->setDocumentMargin(0);
       // 取文档渲染后的真实内容高度
       int totalHeight = edit->document()->size().height();
       // 叠加控件自身上下边框的宽度
       totalHeight += edit->frameWidth() * 2;
       // 如果水平滚动条处于显示状态，叠加滚动条自身高度
       if (edit->horizontalScrollBar()->isVisible()) {
           totalHeight += edit->horizontalScrollBar()->height();
       }
       // 设置固定高度，避免布局拉伸或压缩
       edit->setFixedHeight(totalHeight);
   }
   

3. 关联textChanged信号，内容变化时自动更新高度即可。

修正后的完整代码 #

void TestWindow::setupUi(QWidget *parent)
{
    QVBoxLayout *v_box0 = new QVBoxLayout(parent);
    v_box0->setContentsMargins(0, 0, 0, 0);

    QVBoxLayout *v_scroll_layout = new QVBoxLayout();
    v_scroll_layout->setContentsMargins(0, 0, 0, 0);
    v_scroll_layout->setSpacing(0);
    v_scroll_layout->setAlignment(Qt::AlignTop);

    QWidget *scroll_content = new QWidget();
    scroll_content->setLayout(v_scroll_layout);

    QScrollArea *v_scroll = new QScrollArea();
    v_scroll->setWidgetResizable(true);
    v_scroll->setWidget(scroll_content);
    v_box0->addWidget(v_scroll);

    // 高度更新逻辑
    auto updateHeight = [](QTextEdit* edit) {
        edit->document()->setDocumentMargin(0);
        int h = edit->document()->size().height();
        h += edit->frameWidth() * 2;
        if (edit->horizontalScrollBar()->isVisible()) {
            h += edit->horizontalScrollBar()->height();
        }
        edit->setFixedHeight(h);
    };

    QTextEdit *edit0 = new QTextEdit();
    edit0->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
    edit0->setLineWrapMode(QTextEdit::NoWrap);
    edit0->setFont(viewer_font);
    edit0->setText("Hello World 1\n1\n2\n3\n4\n5\n6\n7\n8\n9\n10\n11");
    updateHeight(edit0);
    connect(edit0, &QTextEdit::textChanged, this, [=](){
        updateHeight(edit0);
    });

    QTextEdit *edit1 = new QTextEdit();
    edit1->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
    edit1->setLineWrapMode(QTextEdit::NoWrap);
    edit1->setFont(viewer_font);
    edit1->setText("New item");
    updateHeight(edit1);
    connect(edit1, &QTextEdit::textChanged, this, [=](){
        updateHeight(edit1);
    });

    v_scroll_layout->addWidget(edit0);
    v_scroll_layout->addWidget(edit1);

    setFixedHeight(300);
}

注意事项 #

• 不要用QFontMetrics计算多行富文本/纯文本的布局高度，它无法处理行高、边距、换行等渲染细节，返回值和实际渲染尺寸偏差较大，直接调用QTextDocument::size()获取的是Qt布局引擎计算后的真实尺寸，精度完全可靠
• 尺寸计算必须在文本内容、边距参数设置完成后执行，顺序错误会导致计算基准不对
• 水平滚动条的高度需要动态判断，不要写死固定值，不同系统、不同样式下滚动条尺寸存在差异
• 用setFixedHeight替代setMinimumHeight，避免布局过程中控件被拉伸到多余高度，或者被压缩到小于内容高度

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