PyQt5如何实现QTabWidget切换标签时自适应不同子控件尺寸

云上老周

2026-8-29

问题描述

主窗口仅承载单个QTabWidget，且已为主窗口设置布局实现尺寸调整时的自适应效果。两个标签页子控件通过Qt Designer制作，制作逻辑与独立窗口一致，均已配置布局，尺寸策略统一设置为QSizePolicy.Preferred, QSizePolicy.Preferred，且各自配置了独立的默认尺寸与最小尺寸。
核心需求：切换不同标签时，QTabWidget能够适配当前标签对应QWidget的最小尺寸。

默认情况下QTabWidget会始终适配所有标签页子控件中的最大尺寸，即便切换到最小尺寸更小的标签页，窗口也无法缩小。曾参考社区同类问题的实现方案编写切换回调，实测不仅无效，还会导致窗口异常扩大。

复现代码

from PyQt5 import QtCore, QtGui, QtWidgets

class Ui_Form1(object):
    def setupUi(self, Form1):
        Form1.setObjectName("Form1")
        Form1.resize(400, 300)
        Form1.setMinimumSize(QtCore.QSize(400, 300))
        self.horizontalLayout = QtWidgets.QHBoxLayout(Form1)
        self.horizontalLayout.setObjectName("horizontalLayout")
        self.pushButton = QtWidgets.QPushButton(Form1)
        self.pushButton.setObjectName("pushButton")
        self.horizontalLayout.addWidget(self.pushButton)

        self.retranslateUi(Form1)
        QtCore.QMetaObject.connectSlotsByName(Form1)

    def retranslateUi(self, Form1):
        _translate = QtCore.QCoreApplication.translate
        Form1.setWindowTitle(_translate("Form1", "Form"))
        self.pushButton.setText(_translate("Form1", "Test1"))

class Ui_Form2(object):
    def setupUi(self, Form2):
        Form2.setObjectName("Form2")
        Form2.resize(261, 205)
        Form2.setMinimumSize(QtCore.QSize(261, 205))
        self.horizontalLayout = QtWidgets.QHBoxLayout(Form2)
        self.horizontalLayout.setObjectName("horizontalLayout")
        self.pushButton = QtWidgets.QPushButton(Form2)
        self.pushButton.setObjectName("pushButton")
        self.horizontalLayout.addWidget(self.pushButton)

        self.retranslateUi(Form2)
        QtCore.QMetaObject.connectSlotsByName(Form2)

    def retranslateUi(self, Form2):
        _translate = QtCore.QCoreApplication.translate
        Form2.setWindowTitle(_translate("Form2", "Form"))
        self.pushButton.setText(_translate("Form2", "Test2"))

class Ui_mainWindow(object):
    def setupUi(self, mainWindow):
        mainWindow.setObjectName("mainWindow")
        mainWindow.setWindowModality(QtCore.Qt.ApplicationModal)
        self.horizontalLayout = QtWidgets.QHBoxLayout(mainWindow)
        self.horizontalLayout.setObjectName("horizontalLayout")
        self.tabWidget = QtWidgets.QTabWidget(mainWindow)
        self.tabWidget.setObjectName("tabWidget")
        self.horizontalLayout.addWidget(self.tabWidget)

        self.retranslateUi(mainWindow)
        QtCore.QMetaObject.connectSlotsByName(mainWindow)

    def retranslateUi(self, mainWindow):
        _translate = QtCore.QCoreApplication.translate
        mainWindow.setWindowTitle(_translate("mainWindow", "calc"))

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    Form1 = QtWidgets.QWidget()
    ui1 = Ui_Form1()
    ui1.setupUi(Form1)

    Form2 = QtWidgets.QWidget()
    ui2 = Ui_Form2()
    ui2.setupUi(Form2)

    Form3 = QtWidgets.QWidget()
    ui3 = Ui_mainWindow()
    ui3.setupUi(Form3)
    ui3.tabWidget.addTab(Form1, "test1")
    ui3.tabWidget.addTab(Form2, "test2")
    Form3.show()

    sys.exit(app.exec_())

之前尝试的无效实现

self.mainW.tabWidget.currentChanged.connect(self.updateSize)
def updateSize(self, index):
    sizePolicyI = QSizePolicy(QSizePolicy.Ignored, QSizePolicy.Ignored)
    sizePolicyP = QSizePolicy(QSizePolicy.Preferred, QSizePolicy.Preferred)

    for i in range(self.mainW.tabWidget.count()):
        if not i == index:
            self.mainW.tabWidget.widget(i).setSizePolicy(sizePolicyI)
    self.mainW.tabWidget.widget(index).setSizePolicy(sizePolicyP)
    self.mainW.tabWidget.widget(index).resize(self.mainW.tabWidget.widget(index).minimumSizeHint())
    self.mainW.tabWidget.widget(index).adjustSize()
    self.mainW.resize(self.mainW.minimumSizeHint())
    self.mainW.adjustSize()

问题原因

之前方案无效的核心问题有两点：

仅修改子控件尺寸策略后，没有强制刷新QTabWidget和顶层窗口的尺寸缓存，minimumSizeHint始终保留首次计算的最大标签尺寸，导致resize调用不生效
尺寸计算时没有计入QTabWidget的标签栏高度、内容边距、布局边距，手动设置的尺寸和实际需求尺寸存在偏差，会引发窗口尺寸异常

修复方案

在标签切换回调中，修改非激活标签的尺寸策略后，按顺序触发控件、布局、顶层窗口的尺寸重算，确保尺寸缓存被清空，最终调用adjustSize自动适配最小尺寸。
修改后的完整可运行代码如下：

from PyQt5 import QtCore, QtGui, QtWidgets

class Ui_Form1(object):
    def setupUi(self, Form1):
        Form1.setObjectName("Form1")
        Form1.resize(400, 300)
        Form1.setMinimumSize(QtCore.QSize(400, 300))
        self.horizontalLayout = QtWidgets.QHBoxLayout(Form1)
        self.horizontalLayout.setObjectName("horizontalLayout")
        self.pushButton = QtWidgets.QPushButton(Form1)
        self.pushButton.setObjectName("pushButton")
        self.horizontalLayout.addWidget(self.pushButton)

        self.retranslateUi(Form1)
        QtCore.QMetaObject.connectSlotsByName(Form1)

    def retranslateUi(self, Form1):
        _translate = QtCore.QCoreApplication.translate
        Form1.setWindowTitle(_translate("Form1", "Form"))
        self.pushButton.setText(_translate("Form1", "Test1"))

class Ui_Form2(object):
    def setupUi(self, Form2):
        Form2.setObjectName("Form2")
        Form2.resize(261, 205)
        Form2.setMinimumSize(QtCore.QSize(261, 205))
        self.horizontalLayout = QtWidgets.QHBoxLayout(Form2)
        self.horizontalLayout.setObjectName("horizontalLayout")
        self.pushButton = QtWidgets.QPushButton(Form2)
        self.pushButton.setObjectName("pushButton")
        self.horizontalLayout.addWidget(self.pushButton)

        self.retranslateUi(Form2)
        QtCore.QMetaObject.connectSlotsByName(Form2)

    def retranslateUi(self, Form2):
        _translate = QtCore.QCoreApplication.translate
        Form2.setWindowTitle(_translate("Form2", "Form"))
        self.pushButton.setText(_translate("Form2", "Test2"))

class Ui_mainWindow(object):
    def setupUi(self, mainWindow):
        mainWindow.setObjectName("mainWindow")
        mainWindow.setWindowModality(QtCore.Qt.ApplicationModal)
        self.horizontalLayout = QtWidgets.QHBoxLayout(mainWindow)
        self.horizontalLayout.setObjectName("horizontalLayout")
        self.tabWidget = QtWidgets.QTabWidget(mainWindow)
        self.tabWidget.setObjectName("tabWidget")
        self.horizontalLayout.addWidget(self.tabWidget)

        self.retranslateUi(mainWindow)
        QtCore.QMetaObject.connectSlotsByName(mainWindow)

    def retranslateUi(self, mainWindow):
        _translate = QtCore.QCoreApplication.translate
        mainWindow.setWindowTitle(_translate("mainWindow", "calc"))

class MainWindow(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.ui = Ui_mainWindow()
        self.ui.setupUi(self)
        
        # 插入两个标签页
        self.form1 = QtWidgets.QWidget()
        ui1 = Ui_Form1()
        ui1.setupUi(self.form1)
        self.ui.tabWidget.addTab(self.form1, "test1")
        
        self.form2 = QtWidgets.QWidget()
        ui2 = Ui_Form2()
        ui2.setupUi(self.form2)
        self.ui.tabWidget.addTab(self.form2, "test2")
        
        # 绑定切换信号
        self.ui.tabWidget.currentChanged.connect(self.update_tab_size)
        # 初始化时适配第一个标签的尺寸
        self.update_tab_size(0)

    def update_tab_size(self, index):
        policy_ignored = QtWidgets.QSizePolicy(
            QtWidgets.QSizePolicy.Ignored, 
            QtWidgets.QSizePolicy.Ignored
        )
        policy_preferred = QtWidgets.QSizePolicy(
            QtWidgets.QSizePolicy.Preferred, 
            QtWidgets.QSizePolicy.Preferred
        )
        
        # 遍历所有标签，非激活标签设置为Ignored策略，不参与尺寸计算
        for i in range(self.ui.tabWidget.count()):
            widget = self.ui.tabWidget.widget(i)
            if i != index:
                widget.setSizePolicy(policy_ignored)
            else:
                widget.setSizePolicy(policy_preferred)
        
        # 按顺序触发尺寸重算，清空缓存
        current_widget = self.ui.tabWidget.widget(index)
        current_widget.updateGeometry()
        self.ui.tabWidget.updateGeometry()
        self.updateGeometry()
        # 自动调整到最小合适尺寸
        self.adjustSize()

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    w = MainWindow()
    w.show()
    sys.exit(app.exec_())

效果说明

运行后切换标签时，窗口会自动适配当前标签页的最小尺寸：切换到test1标签时窗口尺寸匹配400*300的子控件要求，切换到test2标签时自动缩小到对应尺寸，不会出现窗口异常扩大、无法缩小的问题。

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

PyQt5如何实现QTabWidget切换标签时自适应不同子控件尺寸

复现代码 #

之前尝试的无效实现 #

效果说明 #

复现代码

之前尝试的无效实现

效果说明