PyQt5 QDockWidget内嵌QScrollArea时控件与滚动条不显示如何解决

你的代码存在3个直接导致控件不显示的错误：

• QScrollArea禁止手动给自身设置布局：你写的self.scrollLayout = QHBoxLayout(self.scroll)是核心错误。QScrollArea有自带的内部viewport渲染结构，手动给它追加布局会直接覆盖掉你通过setWidget()绑定的内容容器，导致内部控件全部无法渲染
• 无意义嵌套多余容器：你额外创建的dockerWidget没有任何实际作用，反而因为布局没有正确约束QScrollArea的尺寸，导致滚动区域被压缩到不可见
• 无效的几何尺寸设置：self.scroll.setGeometry(10, 10, 100, 100)不会生效，当控件被加入布局后，尺寸和位置完全由布局接管，手动设置的geometry参数会被布局自动覆盖。

QDockWidget嵌套QScrollArea不需要多余的中间层，正确的层级逻辑非常简单：

1. 把所有业务控件放在一个普通QWidget里，给这个QWidget设置你需要的布局（比如你用的QGridLayout）
2. 把这个内容QWidget通过setWidget()方法绑定到QScrollArea上，配置好滚动条策略和setWidgetResizable(True)
3. 直接把QScrollArea通过QDockWidget的setWidget()方法设为停靠窗口的内容即可，不需要额外套其他容器。

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

class DockWindow(QMainWindow):
    def __init__(self,parent=None):
        super(DockWindow, self).__init__(parent)
        
        self.docker = QDockWidget()
        
        # 初始化滚动区域
        self.scroll = QScrollArea()
        self.scroll.setVerticalScrollBarPolicy(Qt.ScrollBarAsNeeded)
        self.scroll.setHorizontalScrollBarPolicy(Qt.ScrollBarAsNeeded)
        self.scroll.setWidgetResizable(True)
        
        # 初始化内容容器，放置所有按钮
        self.content_widget = QWidget()
        self.grid = QGridLayout()
        for i in range(1,50):
            for j in range(1,5):
                # 不要用object做变量名，会覆盖Python内置类型
                btn = QPushButton(f"btn {i};{j}")
                self.grid.addWidget(btn, i, j)
        self.content_widget.setLayout(self.grid)
        
        # 绑定内容到滚动区域
        self.scroll.setWidget(self.content_widget)
        # 直接将滚动区域设置为停靠窗口的内容
        self.docker.setWidget(self.scroll)
        
        self.setCentralWidget(QTextEdit())
        self.addDockWidget(Qt.RightDockWidgetArea, self.docker)
        
        self.setGeometry(600, 100, 1000, 900)
        self.setWindowTitle('Scroll Area Demonstration')

if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = DockWindow()
    demo.show()
    sys.exit(app.exec_())

补充说明：如果后续你需要在停靠窗口的滚动区域外添加其他固定控件（比如顶部的筛选栏、底部的操作按钮组），才需要增加中间容器QWidget：此时给中间容器设置垂直/水平布局，先放固定控件，再把QScrollArea加入布局并设置拉伸占满剩余空间，同时记得把布局的边距设为0，避免出现多余空白或者尺寸约束异常。

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