Ubuntu下打开新QDockWidget时旧浮动QDockWidget自动关闭问题

问题根源 #

这是PyQt在不同桌面环境窗口管理器下的行为差异：Windows对浮动QDockWidget的实例管理逻辑会保留独立窗口，而Ubuntu（GNOME/KDE等）下，当替换主窗口内的dock部件时，浮动状态的dock实例会被意外销毁。

解决思路 #

通过手动维护浮动QDockWidget的实例引用，避免其被Python垃圾回收机制回收，同时仅操作主窗口固定区域内的dock部件：

• 用列表存储所有处于浮动状态的QDockWidget实例
• 切换列表项目时，只替换主窗口固定区域内的dock内容，不触动浮动的实例
• 监听dock的状态变化和关闭事件，动态更新实例列表

实现代码 #

from PyQt5.QtWidgets import (QMainWindow, QListWidget, QDockWidget, 
                             QWidget, QVBoxLayout, QLineEdit)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("DockWidget Test")
        self.resize(800, 600)

        # 中央列表部件
        self.list_widget = QListWidget()
        self.list_widget.addItems(["Item 1", "Item 2", "Item 3"])
        self.setCentralWidget(self.list_widget)
        self.list_widget.currentItemChanged.connect(self.on_item_changed)

        # 存储所有浮动dock实例，防止被回收
        self.floating_docks = []
        # 当前停靠在主窗口固定区域的dock
        self.anchored_dock = None

    def on_item_changed(self, current, previous):
        if not current:
            return
        
        # 仅处理固定区域内的dock，替换其内容
        if self.anchored_dock and not self.anchored_dock.isFloating():
            self.removeDockWidget(self.anchored_dock)
            self.anchored_dock.deleteLater()
        
        # 创建新的编辑dock并添加到右侧固定区域
        edit_dock = QDockWidget(f"Edit {current.text()}", self)
        edit_widget = QWidget()
        layout = QVBoxLayout(edit_widget)
        layout.addWidget(QLineEdit(current.text()))
        edit_dock.setWidget(edit_widget)
        
        self.addDockWidget(1, edit_dock)
        self.anchored_dock = edit_dock

        # 监听dock浮动状态变化，维护实例列表
        def update_floating_list():
            if edit_dock.isFloating():
                if edit_dock not in self.floating_docks:
                    self.floating_docks.append(edit_dock)
            else:
                if edit_dock in self.floating_docks:
                    self.floating_docks.remove(edit_dock)
        
        edit_dock.topLevelChanged.connect(update_floating_list)
        # dock关闭时从列表移除引用
        edit_dock.closeEvent = lambda event: self.floating_docks.remove(edit_dock)

if __name__ == "__main__":
    import sys
    from PyQt5.QtWidgets import QApplication
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

核心要点 #

• floating_docks列表是关键，它持有浮动dock的引用，避免被Python自动回收
• topLevelChanged信号用于跟踪dock的浮动/停靠状态，确保实例列表实时更新
• 仅对非浮动状态的dock进行替换操作，完全保留用户拖出的浮动窗口

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