PyQt5主窗口中含QTableWidget的中央部件无法正确缩放问题

问题说明 #

在PyQt5的QMainWindow中，将包含多个QTableWidget的QDialog作为中央部件时，遇到以下问题：

• 设置tableWidget.setMinimumHeight(10)后，窗口缩小后滚动条无法正常使用，部件显示异常
• 移除该行代码后，表格行与水平滚动条之间出现空白
• 尝试用verticalHeader().setStretchLastSection(True)消除空白，但行高过大，手动调整行高无效

用户提供的测试代码：

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *

class MainWindow(QMainWindow):
    
    def __init__(self, parent=None):
        super(MainWindow, self).__init__(parent)
        
        # the central widget
        scrollArea = QScrollArea()
        scrollArea.setWidgetResizable(True)
        self.centerWidget = QDialog()
        self.centerWidgetLayout = QVBoxLayout()
        self.centerWidget.setLayout(self.centerWidgetLayout)
        scrollArea.setWidget(self.centerWidget)
        self.setCentralWidget(scrollArea)
        
        self.populateLayout()
    
    def defineTable(self, ncols):
        tableWidget = QTableWidget()
        tableWidget.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
        tableWidget.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOn)
        tableWidget.verticalHeader().hide()
        tableWidget.horizontalHeader().hide()
        tableWidget.setMinimumHeight(10)
        tableWidget.horizontalHeader().setDefaultSectionSize(50)
        tableWidget.horizontalHeader().setHighlightSections(False)
        tableWidget.horizontalHeader().setSortIndicatorShown(False)
        tableWidget.horizontalHeader().setStretchLastSection(False)
        tableWidget.setColumnCount(ncols )
        tableWidget.setRowCount(1)
        for col in range(ncols):
            tableWidget.setItem( 0, col, QTableWidgetItem("lalala"))
        return tableWidget
        
    def populateLayout(self):
        for i in range(6):
            self.centerWidgetLayout.addWidget( self.defineTable(i+1) )


if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = MainWindow()
    ex.show()
    sys.exit(app.exec_())

核心原因 #

• setMinimumHeight(10)强制固定了表格的最小高度，打破了QScrollArea和布局管理器的尺寸计算逻辑，导致滚动区域无法正确判断内容高度，进而引发滚动异常
• 移除该行后出现空白，是因为QTableWidget默认的高度计算包含了垂直表头的预留空间，加上水平滚动条的高度后，内容行无法填满表格高度

解决步骤 #

1. 移除错误的最小高度设置 #

直接删掉tableWidget.setMinimumHeight(10)，让布局管理器自动处理表格高度。

2. 固定行高并消除空白 #

不要用verticalHeader().setStretchLastSection(True)，而是直接设置行高，同时确保表格高度贴合内容：

def defineTable(self, ncols):
    tableWidget = QTableWidget()
    tableWidget.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
    tableWidget.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOn)
    tableWidget.verticalHeader().hide()
    tableWidget.horizontalHeader().hide()
    
    # 关闭垂直表头拉伸，避免行高被强制放大
    tableWidget.verticalHeader().setStretchLastSection(False)
    # 根据字体计算合适的行高，加8px上下留白
    font_height = QFontMetrics(tableWidget.font()).height()
    tableWidget.setRowHeight(0, font_height + 8)
    
    tableWidget.horizontalHeader().setDefaultSectionSize(50)
    tableWidget.horizontalHeader().setHighlightSections(False)
    tableWidget.horizontalHeader().setSortIndicatorShown(False)
    tableWidget.horizontalHeader().setStretchLastSection(False)
    tableWidget.setColumnCount(ncols )
    tableWidget.setRowCount(1)
    for col in range(ncols):
        tableWidget.setItem( 0, col, QTableWidgetItem("lalala"))
    
    # 计算表格总高度：行高 + 水平滚动条高度
    scrollbar_height = tableWidget.horizontalScrollBar().sizeHint().height()
    tableWidget.setFixedHeight(tableWidget.rowHeight(0) + scrollbar_height)
    
    return tableWidget

3. 优化布局间距（可选） #

如果表格之间存在多余空白，可以调整布局的间距和边距：

def __init__(self, parent=None):
    super(MainWindow, self).__init__(parent)
    
    scrollArea = QScrollArea()
    scrollArea.setWidgetResizable(True)
    self.centerWidget = QDialog()
    self.centerWidgetLayout = QVBoxLayout()
    # 设置布局间距和边距为0，消除多余空白
    self.centerWidgetLayout.setSpacing(0)
    self.centerWidgetLayout.setContentsMargins(0, 0, 0, 0)
    self.centerWidget.setLayout(self.centerWidgetLayout)
    scrollArea.setWidget(self.centerWidget)
    self.setCentralWidget(scrollArea)
    
    self.populateLayout()

修改后的完整代码 #

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *

class MainWindow(QMainWindow):
    
    def __init__(self, parent=None):
        super(MainWindow, self).__init__(parent)
        
        # the central widget
        scrollArea = QScrollArea()
        scrollArea.setWidgetResizable(True)
        self.centerWidget = QDialog()
        self.centerWidgetLayout = QVBoxLayout()
        self.centerWidgetLayout.setSpacing(0)
        self.centerWidgetLayout.setContentsMargins(0, 0, 0, 0)
        self.centerWidget.setLayout(self.centerWidgetLayout)
        scrollArea.setWidget(self.centerWidget)
        self.setCentralWidget(scrollArea)
        
        self.populateLayout()
    
    def defineTable(self, ncols):
        tableWidget = QTableWidget()
        tableWidget.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
        tableWidget.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOn)
        tableWidget.verticalHeader().hide()
        tableWidget.horizontalHeader().hide()
        
        # 配置行高和表格高度
        tableWidget.verticalHeader().setStretchLastSection(False)
        font_height = QFontMetrics(tableWidget.font()).height()
        tableWidget.setRowHeight(0, font_height + 8)
        scrollbar_height = tableWidget.horizontalScrollBar().sizeHint().height()
        tableWidget.setFixedHeight(tableWidget.rowHeight(0) + scrollbar_height)
        
        tableWidget.horizontalHeader().setDefaultSectionSize(50)
        tableWidget.horizontalHeader().setHighlightSections(False)
        tableWidget.horizontalHeader().setSortIndicatorShown(False)
        tableWidget.horizontalHeader().setStretchLastSection(False)
        tableWidget.setColumnCount(ncols )
        tableWidget.setRowCount(1)
        for col in range(ncols):
            tableWidget.setItem( 0, col, QTableWidgetItem("lalala"))
        return tableWidget
        
    def populateLayout(self):
        for i in range(6):
            self.centerWidgetLayout.addWidget( self.defineTable(i+1) )


if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = MainWindow()
    ex.show()
    sys.exit(app.exec_())

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