PyQt6中如何让水平布局内的两个区域保持等宽可拉伸

要让水平布局中的两个区域始终保持等宽且支持窗口拉伸，核心是利用布局的拉伸因子（stretch factor），给两个区域设置相同的拉伸比例即可。

关键修改步骤 #

在将左右区域的容器控件添加到水平布局时，为每个控件指定相同的stretch参数（比如stretch=1），这样窗口拉伸时，额外的空间会按比例平均分配给两个区域，确保它们始终等宽。

修改后的完整代码示例 #

from PyQt6.QtWidgets import (QWidget, QHBoxLayout, QVBoxLayout, QTabWidget, QApplication, QLabel)
import sys

class EqualWidthTab(QWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()

    def init_ui(self):
        # 创建水平主布局
        main_h_layout = QHBoxLayout(self)

        # 左侧区域：用QWidget包裹垂直布局
        left_container = QWidget()
        left_v_layout = QVBoxLayout(left_container)
        left_v_layout.addWidget(QLabel("左侧内容区域"))
        # 可添加更多控件到左侧垂直布局

        # 右侧区域：用QWidget包裹垂直布局
        right_container = QWidget()
        right_v_layout = QVBoxLayout(right_container)
        right_v_layout.addWidget(QLabel("右侧内容区域"))
        # 可添加更多控件到右侧垂直布局

        # 核心：设置相同的拉伸因子，确保等宽
        main_h_layout.addWidget(left_container, stretch=1)
        main_h_layout.addWidget(right_container, stretch=1)

        # 可选：调整布局间距和边距
        main_h_layout.setSpacing(15)
        main_h_layout.setContentsMargins(20, 20, 20, 20)

class MainWindow(QTabWidget):
    def __init__(self):
        super().__init__()
        self.addTab(EqualWidthTab(), "等宽布局标签")
        self.setWindowTitle("PyQt6 等宽拉伸示例")
        self.resize(600, 400)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

原理说明 #

• PyQt的QHBoxLayout中，stretch参数决定了控件在布局可用空间变化时的分配权重。当两个控件的stretch值相等时，它们会平分所有额外的拉伸空间，从而保持宽度始终一致。
• 使用QWidget作为垂直布局的容器，是为了让布局的拉伸行为更可控，避免直接嵌套布局带来的不可预期的空间分配问题。

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