如何用PySide6设置QTabWidget样式并让子控件占满空间

要解决QTabWidget子控件无法填满空间、存在内边距，以及标签栏位置不对的问题，核心是通过**Qt样式表（QSS）**修改默认样式，同时确保父布局没有额外间距，具体操作如下：

1. 移除QTabWidget的内边距 #

QTabWidget的子页面容器（::pane）默认带有内边距和边框，通过QSS可以直接清除：

tab_widget.setStyleSheet("""
    QTabWidget::pane {
        border: none;  /* 移除默认边框 */
        padding: 0px;  /* 清除内边距，让子控件完全填充 */
    }
""")

2. 让标签栏顶部对齐 #

默认情况下部分样式的QTabWidget标签栏可能不会顶格，通过设置QTabWidget的对齐属性强制顶部对齐：

tab_widget.setStyleSheet("""
    QTabWidget::pane {
        border: none;
        padding: 0px;
    }
    QTabWidget {
        alignment: top;  /* 标签栏顶部对齐 */
    }
""")

3. 调整标签自身的紧凑度（可选） #

如果觉得标签栏的标签过于宽松，可以调整标签的内边距：

tab_widget.setStyleSheet("""
    QTabWidget::pane {
        border: none;
        padding: 0px;
    }
    QTabWidget {
        alignment: top;
    }
    QTabBar::tab {
        padding: 4px 8px;  /* 自定义标签的上下/左右内边距，按需调整 */
    }
""")

4. 确保父布局无额外间距 #

如果QTabWidget嵌套在父布局中，需要清除布局的外边距和间距，避免父容器带来的空白：

from PySide6.QtWidgets import QVBoxLayout, QWidget

main_widget = QWidget()
layout = QVBoxLayout(main_widget)
layout.setContentsMargins(0, 0, 0, 0)  # 移除布局的上下左右外边距
layout.setSpacing(0)  # 移除布局内控件间的间距
layout.addWidget(tab_widget)

完整示例代码 #

from PySide6.QtWidgets import QApplication, QTabWidget, QWidget, QVBoxLayout

app = QApplication([])

# 创建QTabWidget并设置样式
tab_widget = QTabWidget()
tab_widget.setStyleSheet("""
    QTabWidget::pane {
        border: none;
        padding: 0px;
    }
    QTabWidget {
        alignment: top;
    }
    QTabBar::tab {
        padding: 4px 8px;
    }
""")

# 添加测试子控件，用背景色直观显示填充效果
tab1 = QWidget()
tab1.setStyleSheet("background-color: #ff4444;")
tab_widget.addTab(tab1, "标签1")

tab2 = QWidget()
tab2.setStyleSheet("background-color: #4444ff;")
tab_widget.addTab(tab2, "标签2")

# 父布局处理（如果需要）
main_widget = QWidget()
layout = QVBoxLayout(main_widget)
layout.setContentsMargins(0, 0, 0, 0)
layout.setSpacing(0)
layout.addWidget(tab_widget)

main_widget.show()
app.exec()

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