PySide6类浏览器标签页：关闭非当前标签页异常问题排查

核心问题1：标签页关闭逻辑错误 #

你直接调用self._tabBar.removeTab(index)移除标签，破坏了QTabWidget的内部状态同步机制。QTabWidget作为标签容器，本身提供了removeTab方法，会同步更新tabBar和内部widget的管理状态；手动操作tabBar会导致索引混乱，进而触发同时关闭多个标签的异常。

核心问题2：SelectionPage布局操作错误 #

在get_portfolio_page方法中，你先执行self.vbox.deleteLater()标记布局待删除，之后又尝试用这个已废弃的布局添加新部件，这会导致布局管理异常，引发控件状态混乱，间接影响标签页的稳定性。

修复代码 #

1. 修正ShrinkTabWidget的close_tab方法 #

改用QTabWidget自带的removeTab方法同步状态，再手动清理widget避免内存泄漏：

def close_tab(self, index):
    widget = self.widget(index)
    self.removeTab(index)
    widget.deleteLater()

2. 修正SelectionPage的get_portfolio_page方法 #

清空布局内的所有部件而非删除布局，再添加新页面：

def get_portfolio_page(self):
    # 清空布局内的所有部件
    while self.vbox.count():
        item = self.vbox.takeAt(0)
        if item.widget():
            item.widget().deleteLater()
    # 添加新的PortfolioPage
    portfolio_page = PortfolioPage()
    self.vbox.addWidget(portfolio_page)

完整修复后的代码 #

from PySide6 import QtWidgets
from PySide6 import QtCore
from PySide6.QtCore import Signal, QSize
from PySide6.QtWidgets import QLabel, QWidget, QHBoxLayout, QVBoxLayout


class ShrinkTabBar(QtWidgets.QTabBar):
    _widthHint = -1
    _initialized = False
    _recursiveCheck = False

    addClicked = Signal()

    def __init__(self, parent):
        super(ShrinkTabBar, self).__init__(parent)
        self.setElideMode(QtCore.Qt.TextElideMode.ElideRight)
        self.setExpanding(False)
        self.setTabsClosable(True)
        self.addButton = QtWidgets.QToolButton(self.parent(), text='+')
        self.addButton.clicked.connect(self.addClicked)
        self._recursiveTimer = QtCore.QTimer(singleShot=True, timeout=self._unsetRecursiveCheck, interval=0)
        self._tabHint = QSize(0, 0)
        self._minimumHint = QSize(0, 0)

    def _unsetRecursiveCheck(self):
        self._recursiveCheck = False

    def _computeHints(self):
        if not self.count() or self._recursiveCheck:
            return
        self._recursiveCheck = True

        opt = QtWidgets.QStyleOptionTab()
        self.initStyleOption(opt, 0)
        width = self.style().pixelMetric(QtWidgets.QStyle.PixelMetric.PM_TabBarTabHSpace, opt, self)
        iconWidth = self.iconSize().width() + 4
        self._minimumWidth = width + iconWidth

        # default text widths are arbitrary
        fm = self.fontMetrics()
        self._minimumCloseWidth = self._minimumWidth + fm.horizontalAdvance('x' * 4) + iconWidth
        self._defaultWidth = width + fm.horizontalAdvance('x' * 17)
        self._defaultHeight = super().tabSizeHint(0).height()
        self._minimumHint = QtCore.QSize(self._minimumWidth, self._defaultHeight)
        self._defaultHint = self._tabHint = QtCore.QSize(self._defaultWidth, self._defaultHeight)

        self._initialized = True
        self._recursiveTimer.start()

    def _updateSize(self):
        if not self.count():
            return
        frameWidth = self.style().pixelMetric(
            QtWidgets.QStyle.PixelMetric.PM_DefaultFrameWidth, None, self.parent())
        buttonWidth = self.addButton.sizeHint().width()
        self._widthHint = (self.parent().width() - frameWidth - buttonWidth) // self.count()
        self._tabHint = QtCore.QSize(min(self._widthHint, self._defaultWidth), self._defaultHeight)
        # dirty trick to ensure that the layout is updated
        if not self._recursiveCheck:
            self._recursiveCheck = True
            self.setIconSize(self.iconSize())
            self._recursiveTimer.start()

    def minimumTabSizeHint(self, index):
        if not self._initialized:
            self._computeHints()
        return self._minimumHint

    def tabSizeHint(self, index):
        if not self._initialized:
            self._computeHints()
        return self._tabHint

    def tabLayoutChange(self):
        if self.count() and not self._recursiveCheck:
            self._updateSize()

    def tabRemoved(self, index):
        if not self.count():
            self.addButton.setGeometry(1, 2,
                self.addButton.sizeHint().width(), self.height() - 4)

    def changeEvent(self, event):
        super().changeEvent(event)
        if event.type() in (event.StyleChange, event.FontChange):
            self._updateSize()

    def resizeEvent(self, event):
        if not self.count():
            super().resizeEvent(event)
            return
        self._recursiveCheck = True
        super().resizeEvent(event)
        height = self.sizeHint().height()
        if height < 0:
            # a tab bar without tabs returns an invalid size
            height = self.addButton.height()
        self.addButton.setGeometry(self.geometry().right() + 1, 2,
            self.addButton.sizeHint().width(), height - 4)
        self._recursiveTimer.start()


class ShrinkTabWidget(QtWidgets.QTabWidget):
    addClicked = Signal()

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self._tabBar = ShrinkTabBar(self)
        self.setTabBar(self._tabBar)
        self._tabBar.tabCloseRequested.connect(self.close_tab)
        self._tabBar.addClicked.connect(self.get_page_choices)

    def get_page_choices(self):
        selection_page = SelectionPage()
        index = self.addTab(selection_page, 'New Tab')
        self._tabBar.setCurrentIndex(index)   # Set as current tab

    def resizeEvent(self, event):
        self._tabBar._updateSize()
        super().resizeEvent(event)

    def close_tab(self, index):
        # 修复：使用QTabWidget的removeTab同步状态，再清理widget
        widget = self.widget(index)
        self.removeTab(index)
        widget.deleteLater()


class TabContainer(QWidget):
    def __init__(self):
        super(TabContainer, self).__init__()
        self.setGeometry(150, 150, 650, 350)
        self.tabwidget = ShrinkTabWidget(self)
        self.top_vbox = QtWidgets.QHBoxLayout()
        self.top_vbox.addWidget(self.tabwidget)
        self.setLayout(self.top_vbox)
        self.show()


class SelectionPage(QWidget):
    def __init__(self):
        super(SelectionPage, self).__init__()
        self.vbox = QtWidgets.QVBoxLayout()
        self.portfolio_btn = QtWidgets.QPushButton("Portfolio")
        self.portfolio_btn.clicked.connect(self.get_portfolio_page)
        self.vbox.addWidget(self.portfolio_btn)
        self.setLayout(self.vbox)

    def get_portfolio_page(self):
        # 修复：清空布局内部件而非删除布局
        while self.vbox.count():
            item = self.vbox.takeAt(0)
            if item.widget():
                item.widget().deleteLater()
        portfolio_page = PortfolioPage()
        self.vbox.addWidget(portfolio_page)


class PortfolioPage(QWidget):
    def __init__(self):
        super(PortfolioPage, self).__init__()
        vbox = QVBoxLayout()
        label = QLabel('Test')
        vbox.addWidget(label)
        self.setLayout(vbox)


import sys

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    tab_container = TabContainer()
    tab_container.show()
    sys.exit(app.exec())

验证说明 #

1. 修复关闭逻辑后，调用QTabWidget的removeTab方法确保tabBar和容器内部状态同步，不会出现索引混乱导致的多标签关闭问题。
2. 修复布局操作后，避免了废弃布局的非法使用，保证控件状态稳定，消除了间接引发的异常。

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