本文介绍如何通过自定义 QTabBar 与手动组合 QStackedWidget，构建一个标签栏（垂直排列、左侧显示）与内容区域完全解耦的 Tab 界面，并支持鼠标拖动分割线动态调整标签栏宽度。
本文介绍如何通过自定义 `qtabbar` 与手动组合 `qstackedwidget`，构建一个标签栏（垂直排列、左侧显示）与内容区域完全解耦的 tab 界面，并支持鼠标拖动分割线动态调整标签栏宽度。
在 Qt 中，QTabWidget 默认将标签栏（QTabBar）与其内容区（内部 QStackedWidget）强绑定，且会为标签栏预留固定空间——即使你将其视觉上移出容器，布局系统仍会保留空白区域，导致无法实现真正的“标签栏独立缩放”。要突破这一限制，核心思路是绕过 QTabWidget 的封装逻辑，手动组合 QTabBar 与 QStackedWidget，并由开发者全权控制二者的位置、尺寸和交互。
以下是一个完整、稳定、可扩展的实现方案：
✅ 关键组件设计
VTabBar（垂直标签栏）
继承QTabBar，重写tabSizeHint()实现宽高互换，并在paintEvent()中旋转绘制文字（90°），同时适配关闭按钮位置（若启用setTabsClosable(True)）。注意：必须调用setShape(QTabBar.RoundedWest)以获得更自然的垂直样式。-
DividedTabWidget（解耦式 Tab 容器）
不继承QTabWidget，而是聚合VTabBar+QStackedWidget：- 标签切换通过
tabBar.currentChanged信号连接至stackedWidget.setCurrentIndex； - 标签增删由
insertTab()/removeTab()统一协调两个组件； -
tabBar()和stackedWidget()提供对外访问接口，便于布局嵌入。
- 标签切换通过
✅ 布局结构（使用 QSplitter）
splitter = QSplitter(Qt.Horizontal) # 左侧：仅含 VTabBar（及可选控件，如添加标签按钮） left_panel = QWidget() left_layout = QVBoxLayout(left_panel) left_layout.addWidget(add_tab_btn) # 可选：模拟 corner widget left_layout.addWidget(tab_widget.tabBar()) left_layout.setContentsMargins(0, 0, 0, 0) splitter.addWidget(left_panel) # 右侧：仅显示 QStackedWidget（无任何标签栏残留） splitter.addWidget(tab_widget.stackedWidget())
✅ 此结构彻底消除 QTabWidget 对标签栏的空间占用，QSplitter 的拖拽手柄即可自由调节左右区域宽度，且标签栏宽度变化时内容区自动响应，无重绘错位。
⚠️ 注意事项与最佳实践
-
尺寸策略：
VTabBar应设置setSizePolicy(Fixed, Fixed)，避免其在垂直布局中拉伸；实际宽度由QSplitter控制。 -
标签等宽：若需所有标签项宽度一致（如截图中左列等宽效果），可在
VTabBar.tabSizeHint()中统一返回固定宽度（例如QSize(120, 32)），而非依赖super().tabSizeHint()的文本自适应。 -
关闭按钮定位：示例代码中已修正右上角关闭按钮坐标逻辑，确保其始终位于每个标签右端、垂直居中；若使用不同主题或 DPI，建议改用
opt.rect.adjusted()或QStyle.pixelMetric()进行像素级微调。 -
键盘导航与焦点：
VTabBar默认支持方向键切换标签，无需额外处理；但需确保QStackedWidget中的子控件能正确接收焦点（可通过setFocusPolicy(Qt.StrongFocus)显式设置）。 -
样式定制：可通过
QProxyStyle或QSS深度定制标签外观（如背景色、边框、悬停效果），推荐优先使用 QSS，例如：VTabBar::tab { background: #f0f0f0; border: 1px solid #ccc; min-width: 100px; padding: 8px 4px; } VTabBar::tab:selected { background: #e0e0e0; }
✅ 总结
该方案摒弃了 QTabWidget 的黑盒封装，以组合优于继承的设计思想，实现了标签栏与内容的物理分离与逻辑解耦。它不仅满足鼠标拖拽调整宽度的核心需求，还具备良好的可维护性、可扩展性（如添加右键菜单、拖拽重排、图标支持等），是构建专业级垂直 Tab UI 的推荐范式。对于需要精细控制布局行为的 Qt 桌面应用，此模式比修改 paintEvent 或重写 QTabWidget 内部布局更具鲁棒性与可读性。
