PyQt5使用Designer时QGridLayout内QWidget无法随窗口缩放

核心排查与修复要点 #

• 确保scrollAreaWidgetContents_2的布局配置正确
  1. 选中scrollAreaWidgetContents_2，在右侧属性面板中为它添加一个布局（如QVBoxLayout、QGridLayout均可），不能让它处于无布局的自由放置状态。
  2. 若scrollAreaWidgetContents_2内部还有其他控件，需将这些控件全部添加到它的布局中，保持布局的完整性。
• 开启QScrollArea的自适应属性
  选中外层的QScrollArea，在属性面板里将widgetResizable勾选为true——这是让滚动区域自动调整内部部件尺寸以适配自身变化的关键设置。
• 保证布局链完整无断裂
  从主窗口开始，所有包含QScrollArea的父容器（比如主窗口中央部件、承载QGridLayout的容器）都必须设置有效布局，不能存在无布局的容器。布局链要从主窗口一直延伸到scrollAreaWidgetContents_2的内部布局，这样窗口缩放的尺寸信号才能逐层传递下去。

基于PyQt Designer的具体操作步骤 #

1. 打开test003.ui文件，定位到目标scrollAreaWidgetContents_2。
2. 右键点击该部件，选择布局 -> 添加布局（根据需求选择布局类型）。
3. 选中外层QScrollArea，在右侧属性栏找到widgetResizable并勾选。
4. 检查主窗口中央部件的布局设置，确认承载QScrollArea的QGridLayout已正确应用到父容器上。
5. 保存.ui文件，重新执行pyuic5 test003.ui -o test003.py转换代码，再运行主程序测试。

常见错误点 #

• 仅给QScrollArea设置布局，却未给内部的scrollAreaWidgetContents_2添加布局，导致内部部件无法响应尺寸变化。
• 未开启QScrollArea的widgetResizable属性，即便内部布局正确，滚动区域也不会主动调整内部部件大小。
• 父容器存在无布局状态，导致缩放信号无法传递到下层控件。

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