PyQt5 QTabWidget：如何在类中切换同一窗口内的标签页？

你的问题核心在于每次点击按钮时都新建了一个Tab对话框实例，这自然会弹出新窗口，而非操作原本的标签页容器。要实现同一窗口内的标签切换，我们需要让子标签页能访问到原始的QTabWidget，或是借助Qt的信号槽机制触发父组件的切换动作。

下面提供两种可行的解决方案：

方案1：传递父级TabWidget引用 #

直接在创建子标签页时，将主窗口的QTabWidget实例传递给它们，让子标签页能直接操作这个实例完成切换：

from PyQt5.QtWidgets import QPushButton, QTabWidget, QApplication, QDialog, QVBoxLayout, QWidget
import sys

class Tab(QDialog):
    def __init__(self):
        super().__init__()
        vbox = QVBoxLayout()
        self.tabWidget = QTabWidget()
        # 创建子标签时传入当前的tabWidget实例
        self.tabWidget.addTab(TabContact(self.tabWidget), "Contact Details")
        self.tabWidget.addTab(TabPeronsalDetails(self.tabWidget), "Personal Details")
        vbox.addWidget(self.tabWidget)
        self.setLayout(vbox)

class TabContact(QWidget):
    def __init__(self, parent_tab_widget):
        super().__init__()
        # 保存父级tabWidget的引用
        self.parent_tab = parent_tab_widget
        pushButton = QPushButton("Go to next")
        pushButton.clicked.connect(self.nextTab)
        vbox = QVBoxLayout()
        vbox.addWidget(pushButton)
        self.setLayout(vbox)

    def nextTab(self):
        # 直接操作原始tabWidget，切换到下一个标签（索引1）
        self.parent_tab.setCurrentIndex(1)

class TabPeronsalDetails(QWidget):
    def __init__(self, parent_tab_widget):
        super().__init__()
        self.parent_tab = parent_tab_widget
        pushButton_2 = QPushButton("Go to prior")
        pushButton_2.clicked.connect(self.priorTab)
        vbox = QVBoxLayout()
        vbox.addWidget(pushButton_2)
        self.setLayout(vbox)

    def priorTab(self):
        # 切换到上一个标签（索引0）
        self.parent_tab.setCurrentIndex(0)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    tabdialog = Tab()
    tabdialog.show()
    app.exec()

方案2：使用Qt信号槽机制（更符合Qt设计思想） #

让子标签页定义切换信号，父组件Tab类连接这些信号到QTabWidget的切换方法，这样子组件无需知晓父组件的具体实现，解耦性更强：

from PyQt5.QtWidgets import QPushButton, QTabWidget, QApplication, QDialog, QVBoxLayout, QWidget
from PyQt5.QtCore import pyqtSignal
import sys

class Tab(QDialog):
    def __init__(self):
        super().__init__()
        vbox = QVBoxLayout()
        self.tabWidget = QTabWidget()
        
        # 创建子标签实例
        contact_tab = TabContact()
        personal_tab = TabPeronsalDetails()
        
        # 连接子标签的切换信号到tabWidget的切换方法
        contact_tab.switch_to_tab.connect(lambda idx: self.tabWidget.setCurrentIndex(idx))
        personal_tab.switch_to_tab.connect(lambda idx: self.tabWidget.setCurrentIndex(idx))
        
        self.tabWidget.addTab(contact_tab, "Contact Details")
        self.tabWidget.addTab(personal_tab, "Personal Details")
        vbox.addWidget(self.tabWidget)
        self.setLayout(vbox)

class TabContact(QWidget):
    # 定义切换信号，传递目标标签的索引
    switch_to_tab = pyqtSignal(int)
    
    def __init__(self):
        super().__init__()
        pushButton = QPushButton("Go to next")
        pushButton.clicked.connect(lambda: self.switch_to_tab.emit(1))
        vbox = QVBoxLayout()
        vbox.addWidget(pushButton)
        self.setLayout(vbox)

class TabPeronsalDetails(QWidget):
    switch_to_tab = pyqtSignal(int)
    
    def __init__(self):
        super().__init__()
        pushButton_2 = QPushButton("Go to prior")
        pushButton_2.clicked.connect(lambda: self.switch_to_tab.emit(0))
        vbox = QVBoxLayout()
        vbox.addWidget(pushButton_2)
        self.setLayout(vbox)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    tabdialog = Tab()
    tabdialog.show()
    app.exec()

关键说明 #

• 两种方案都避免了新建Tab实例，直接操作原始的QTabWidget完成切换
• 方案2通过信号槽解耦了子组件与父组件，更适合复杂项目，后续维护更便捷

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