使用QTpy封装的PyQt6开发主窗口时，初始状态右侧垂直排列两个QDockWidget，拖拽重新停靠其中一个后，两个部件之间会出现巨大空白间隙。该问题在Qt4/Qt5中未出现，属于Qt6布局计算逻辑变化导致的兼容性问题。

最小可复现代码 #

from qtpy.QtWidgets import (
    QApplication, QMainWindow, QDockWidget, QWidget, QVBoxLayout, QLabel
)
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Dock Gap Issue")
        self.resize(800, 600)

        # 创建第一个停靠部件
        dock1 = QDockWidget("Dock 1")
        widget1 = QWidget()
        layout1 = QVBoxLayout(widget1)
        layout1.addWidget(QLabel("Content of Dock 1"))
        dock1.setWidget(widget1)

        # 创建第二个停靠部件
        dock2 = QDockWidget("Dock 2")
        widget2 = QWidget()
        layout2 = QVBoxLayout(widget2)
        layout2.addWidget(QLabel("Content of Dock 2"))
        dock2.setWidget(widget2)

        # 初始垂直停靠在右侧
        self.addDockWidget(1, dock1)  # Qt.RightDockWidgetArea
        self.splitDockWidget(dock1, dock2, 2)  # Qt.Vertical

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

解决方案 #

方法1：为QDockWidget设置明确的最小尺寸

Qt6中，若dock widget无尺寸约束，重新停靠后布局管理器可能分配异常空间。为每个dock部件设置合理的最小尺寸，可强制布局保持紧凑：

# 修改dock创建代码，添加最小尺寸约束
dock1 = QDockWidget("Dock 1")
dock1.setMinimumSize(200, 100)  # 根据需求调整尺寸
widget1 = QWidget()
layout1 = QVBoxLayout(widget1)
layout1.addWidget(QLabel("Content of Dock 1"))
dock1.setWidget(widget1)

dock2 = QDockWidget("Dock 2")
dock2.setMinimumSize(200, 100)
widget2 = QWidget()
layout2 = QVBoxLayout(widget2)
layout2.addWidget(QLabel("Content of Dock 2"))
dock2.setWidget(widget2)

方法2：用setStretchFactor控制布局比例

通过setStretchFactor明确指定同一区域内dock部件的拉伸权重，强制布局管理器按比例分配空间：

# 在添加dock部件后添加以下代码
self.setDockWidgetArea(dock1, 1)
self.setDockWidgetArea(dock2, 1)
self.setStretchFactor(dock1, 1)
self.setStretchFactor(dock2, 1)

方法3：重写主窗口resizeEvent（进阶）

若上述方法无效，可重写主窗口的resize事件，强制更新dock布局：

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # ... 原有初始化代码 ...

    def resizeEvent(self, event):
        super().resizeEvent(event)
        # 强制触发dock布局更新
        self.updateDockWidgetLayout()

问题根源 #

Qt6对QDockWidget的布局算法进行了调整，更依赖部件的尺寸策略和约束；而Qt4/Qt5的布局逻辑默认倾向于紧凑分配空间，因此无约束时不会出现间隙问题。

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