实现PyCharm风格QDockWidget标签点击折叠及常驻标签功能

1. 单个停靠部件时强制显示标签 #

QMainWindow默认在停靠区域只有一个部件时会隐藏标签栏，要改这个行为，你可以遍历主窗口的子部件，找到负责管理停靠的QTabWidget，强制让它显示标签栏：

from PyQt5.QtWidgets import QMainWindow, QTabWidget

def force_show_dock_tabs(main_window: QMainWindow):
    # 遍历所有子部件，定位停靠区域的QTabWidget
    for tab_widget in main_window.findChildren(QTabWidget):
        # 排除QDockWidget内部的tab控件，只找主窗口管理停靠的那个
        if not tab_widget.parent().inherits("QDockWidget"):
            tab_widget.setTabBarVisible(True)

如果是单个dock，还可以用个小技巧：把dock和自己tabify一下，这样就能触发标签栏显示：

dock = QDockWidget("Console", self)
dock.setWidget(QWidget())
self.addDockWidget(Qt.BottomDockWidgetArea, dock)
# 手动将dock与自身tabify，强制显示标签栏
self.tabifyDockWidget(dock, dock)

2. 隐藏停靠部件时保留标签（点击切换显示/隐藏） #

默认隐藏QDockWidget会连带标签一起消失，要实现PyCharm那种点击标签切换显示的效果，你需要：

• 监听标签栏的点击事件
• 点击时只切换dock的可见性，不删除标签
• 禁止dock的关闭按钮，避免标签被误删

代码示例：

from PyQt5.QtCore import Qt

def setup_dock_toggle(main_window: QMainWindow):
    for tab_widget in main_window.findChildren(QTabWidget):
        if not tab_widget.parent().inherits("QDockWidget"):
            tab_widget.tabBar().tabBarClicked.connect(lambda idx: toggle_dock(tab_widget, idx, main_window))

def toggle_dock(tab_widget: QTabWidget, tab_idx: int, main_window: QMainWindow):
    # 获取当前停靠区域的所有dock
    first_dock = tab_widget.widget(0)
    if not first_dock:
        return
    docks = main_window.tabifiedDockWidgets(main_window.dockWidgetArea(first_dock))
    if 0 <= tab_idx < len(docks):
        dock = docks[tab_idx]
        # 切换可见性
        dock.setVisible(not dock.isVisible())
        # 强制标签保持可见
        tab_widget.tabBar().setTabVisible(tab_idx, True)

# 给dock设置特性时，移除关闭功能
dock.setFeatures(QDockWidget.DockWidgetFloatable | QDockWidget.DockWidgetMovable)

3. 底部停靠区替换标题栏为标签 #

底部dock默认显示标题栏，要改成标签样式，直接把所有底部dock都加入tabify队列就行，这样主窗口会用统一的标签栏管理它们，不再显示单个dock的标题栏：

# 第一个底部dock
dock_output = QDockWidget("Output", self)
dock_output.setWidget(QWidget())
self.addDockWidget(Qt.BottomDockWidgetArea, dock_output)

# 第二个底部dock，和第一个tabify
dock_terminal = QDockWidget("Terminal", self)
dock_terminal.setWidget(QWidget())
self.addDockWidget(Qt.BottomDockWidgetArea, dock_terminal)
self.tabifyDockWidget(dock_output, dock_terminal)

# 强制显示标签栏（哪怕只有一个dock）
force_show_dock_tabs(self)

核心思路梳理 #

1. 强制所有停靠区域的标签栏始终可见，不管里面有几个dock。
2. 重写标签点击逻辑，只切换dock的显示/隐藏，保留标签。
3. 通过tabify统一管理同区域的dock，替换默认的标题栏显示。

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