PyQt5 QScrollArea设置widget后无法向布局动态添加控件问题

QScrollArea 动态添加控件不显示的核心问题是缺少关键属性配置，和setWidget的调用时机没有必然关系：

• 默认情况下QScrollArea.widgetResizable属性为False，此时滚动区域不会自动根据内部承载widget的内容尺寸调整滚动范围，也不会让内部widget跟随布局内容自动更新自身大小。提前调用setWidget时，内部承载的ckb_area还没有任何子控件，初始尺寸为0，后续往布局里加控件时，ckb_area的尺寸不会自动撑开，所有新增控件都处于可视区域外，自然无法显示。
• 把setWidget挪到所有控件加完之后能正常显示，本质是因为此时ckb_area已经通过布局计算出了正确的初始sizeHint，第一次setWidget时能拿到正确的初始尺寸，但后续再动态加控件依然会出现不显示的问题。

只需要补全必要配置，初始化时就可以提前绑定内部widget，完全支持运行时动态增删控件：

1. 调用setWidget()绑定内部承载widget后，立刻设置self.ckb_area.setWidgetResizable(True)，开启后滚动区域会自动适配内部widget的尺寸变化，内部widget也会自动根据布局内容计算自身高度，宽度默认适配滚动区视口宽度
2. 动态增删控件时，直接操作内部widget持有的布局即可，不需要重复调用setWidget
3. 如果批量添加控件后出现渲染延迟，可以调用一次ckb_area.adjustSize()强制触发尺寸刷新，绝大多数场景不需要额外处理

from PyQt5 import QtCore, QtWidgets

class WidgetWithScroll(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        layout = QtWidgets.QGridLayout()
        self.ckb_area = QtWidgets.QScrollArea()
        # 核心配置：开启滚动区域内容自适应
        self.ckb_area.setWidgetResizable(True)
        ckb_area = QtWidgets.QWidget()
        self.ckb_layout = QtWidgets.QVBoxLayout(ckb_area)
        # 初始化阶段即可绑定内部widget，无需等所有控件加载完成
        self.ckb_area.setWidget(ckb_area)

        layout.addWidget(self.ckb_area, 0, 0)
        # 测试按钮，验证运行时动态添加功能
        self.add_btn = QtWidgets.QPushButton("添加新复选框")
        self.add_btn.clicked.connect(self.add_new_checkbox)
        layout.addWidget(self.add_btn, 1, 0)

        # 初始加载3个复选框
        for i in range(3):
            ckb = QtWidgets.QCheckBox(str(i))
            self.ckb_layout.addWidget(ckb)

        self.setLayout(layout)

    def add_new_checkbox(self):
        # 动态添加逻辑，直接操作布局即可
        new_idx = self.ckb_layout.count()
        ckb = QtWidgets.QCheckBox(str(new_idx))
        self.ckb_layout.addWidget(ckb)

if __name__ == '__main__':
    app = QtWidgets.QApplication([])
    w = WidgetWithScroll()
    w.resize(300, 200)
    w.show()
    app.exec_()

补充说明：如果需要保留横向滚动、不让内部widget自动适配滚动区宽度，可以保持widgetResizable为False，但每次添加控件后需要手动调用ckb_area.resize(ckb_area.sizeHint())更新内部widget尺寸，触发滚动区域刷新范围，这种方式适配成本更高，非特殊需求不推荐使用。

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