如何避免QHBoxLayout内部元素被压缩，实现QScrollArea横向滚动？

你代码的核心问题是没有按照QScrollArea的规范使用方式挂载内容，直接给QScrollArea本身设置布局会导致内容尺寸被滚动区域的视口强制压缩，无法正常触发滚动逻辑。按以下方式修改即可实现预期效果：

核心修改点 #

• 删除直接给QScrollArea设置布局的代码，新增独立的QWidget作为滚动内容的承载容器，将你的QHBoxLayout绑定到该容器
• 调用QScrollArea的setWidget()方法绑定内容容器，同时开启setWidgetResizable(True)保证内容尺寸被正确计算
• 给每个内部的QGroupBox设置水平尺寸策略为QSizePolicy.Minimum，保证控件始终保持刚好容纳内部内容的宽度，不会被压缩
• 配置QScrollArea的水平滚动条策略为按需显示，超出视口范围时自动弹出滚动条

修改后完整代码 #

from PyQt5.QtWidgets import QGroupBox, QHBoxLayout, QLabel, QVBoxLayout, QScrollArea, QWidget, QSizePolicy
from PyQt5.QtCore import Qt

class LayerParamsBox(QGroupBox):
    def __init__(self):
        super().__init__()

        self.setTitle("Layer Parameters")
        self.setLayout(QHBoxLayout())
        self.scroll_area = QScrollArea()
        # 禁用垂直滚动，设置水平滚动条按需显示
        self.scroll_area.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
        self.scroll_area.setHorizontalScrollBarPolicy(Qt.ScrollBarAsNeeded)
        self.scroll_area.setWidgetResizable(True)

        # 创建内容承载容器
        self.scroll_content = QWidget()
        self.scroll_content.setLayout(QHBoxLayout())
        # 绑定容器到滚动区域
        self.scroll_area.setWidget(self.scroll_content)

        self.layout().addWidget(self.scroll_area)

        test = Test("test test")
        for i in range(30):
            self.add_layer(test, i)

    def add_layer(self, layer, n):
        inner_box = QGroupBox()
        # 设置水平尺寸策略为最小尺寸，不允许压缩
        inner_box.setSizePolicy(QSizePolicy.Minimum, QSizePolicy.Minimum)
        inner_box.setLayout(QVBoxLayout())
        inner_box.setTitle(f"Layer {n}")

        label = QLabel(layer.type_name)
        inner_box.layout().addWidget(label)
        # 把控件添加到内容容器的布局里，不是滚动区域的布局
        self.scroll_content.layout().addWidget(inner_box)

class Test:
    def __init__(self, name):
        self.type_name = name

效果验证 #

运行修改后的代码，内部QGroupBox会始终保持刚好展示标题和标签的宽度，当分组框总宽度超出滚动区域视口宽度时，会自动弹出横向滚动条，不会出现控件被压缩的问题。

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