PyQt6 QTableView初始化时resizeRowsToContents无法完全调整行高

启动时让行高正确适配的方法 #

初始化时直接调用resizeRowsToContents()无效，核心原因是此时UI还未完成布局渲染，单元格的最终显示宽度尚未确定——自动换行后的行高计算完全依赖单元格的实际宽度，所以此时计算出的行高是基于临时宽度的错误值。

你可以用以下两种方法解决：

方法1：用QTimer延迟调用 #

将行高调整操作放到事件队列末尾，让UI完成布局后再执行：

from PyQt6.QtCore import QTimer

# 在初始化代码末尾添加
QTimer.singleShot(0, self.table_view.resizeRowsToContents)

singleShot(0)不会真的等待0毫秒，而是让当前所有UI布局任务执行完毕后，再调用目标方法。

方法2：重写showEvent方法 #

在窗口显示完成后（此时布局已稳定）调用行高调整：

def showEvent(self, event):
    super().showEvent(event)
    # 仅首次显示时调用一次即可
    self.table_view.resizeRowsToContents()
    # 保留列宽调整的信号连接，确保后续窗口变化时仍能适配
    self.table_view.horizontalHeader().sectionResized.connect(self.table_view.resizeRowsToContents)

为什么sectionResized信号连接能生效，初始化调用不行？ #

horizontalHeader.sectionResized信号是在列宽调整完成并生效后触发的，此时单元格的实际显示宽度已经完全确定，resizeRowsToContents()可以基于这个准确宽度计算出自动换行后的正确行高。

而初始化阶段，视图处于布局初始化流程中：如果你设置了列宽拉伸（比如setStretchLastSection(True)），此时列宽还在计算中，并未最终确定；即使是固定列宽，视图也还没完成单元格的渲染布局。这时候调用resizeRowsToContents()，只能基于临时的、不准确的单元格宽度计算行高，自然无法适配实际内容。

手动微调窗口时，会触发UI的重新布局，列宽最终确定，此时行高才会被正确计算——这和sectionResized信号触发时的逻辑一致。

完整可运行示例 #

import sys
from PyQt6.QtWidgets import (QApplication, QMainWindow, QTableView, 
                             QStandardItemModel, QStandardItem)
from PyQt6.QtCore import QTimer

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("QTableView 自动换行适配示例")
        self.resize(600, 400)
        
        self.model = QStandardItemModel(2, 1)
        self.table_view = QTableView()
        self.table_view.setModel(self.model)
        
        # 开启自动换行
        self.table_view.setWordWrap(True)
        # 设置列宽自适应窗口
        self.table_view.horizontalHeader().setStretchLastSection(True)
        
        # 添加测试长文本
        long_text = "这是一段超长测试文本，用于验证QTableView自动换行后的行高适配。当文本长度超过单元格宽度时，应该自动折行，行高也需要随之调整以完整显示内容。"
        self.model.setItem(0, 0, QStandardItem(long_text))
        self.model.setItem(1, 0, QStandardItem(long_text * 2))
        
        # 窗口调整时自动适配行高
        self.table_view.horizontalHeader().sectionResized.connect(self.table_view.resizeRowsToContents)
        
        self.setCentralWidget(self.table_view)
        
        # 初始化时延迟适配行高
        QTimer.singleShot(0, self.table_view.resizeRowsToContents)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

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