PYQT 如何为QTabWidget的每个tabBar标签设置不同的背景色

PyQt没有直接提供设置单个tab标签背景色的内置方法，以下是两种常用的稳定实现方案：

方案1：自定义QTabBar（推荐，灵活度最高） #

该方案支持动态给任意索引的标签设置独立背景色，适配标签动态增删的场景，不会和其他组件样式冲突。

• 自定义继承自QTabBar的子类，维护「索引-颜色」的映射字典
• 重写paintEvent方法，绘制默认tab内容前先填充自定义背景色
• 将QTabWidget的默认tabBar替换为自定义类的实例

from PyQt5.QtWidgets import QTabBar, QTabWidget, QApplication, QWidget
from PyQt5.QtGui import QPainter, QColor
from PyQt5.QtCore import Qt

class ColorfulTabBar(QTabBar):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 存储tab索引对应的背景色，key为tab索引，value为QColor对象
        self.tab_bg_colors = {}
    
    def setTabBackgroundColor(self, index, color):
        # 对外暴露的设置背景色方法
        if 0 <= index < self.count():
            self.tab_bg_colors[index] = QColor(color)
            self.update() # 触发重绘生效
    
    def paintEvent(self, event):
        painter = QPainter(self)
        # 先遍历所有有自定义颜色的tab绘制背景
        for index, color in self.tab_bg_colors.items():
            tab_rect = self.tabRect(index)
            painter.fillRect(tab_rect, color)
        # 调用父类绘制方法渲染文字、边框等原有内容，避免覆盖文字
        super().paintEvent(event)

# 用法示例
if __name__ == "__main__":
    import sys
    app = QApplication(sys.argv)
    tab_widget = QTabWidget()
    # 替换默认tabBar为自定义实例
    custom_tab_bar = ColorfulTabBar()
    tab_widget.setTabBar(custom_tab_bar)
    # 新增测试标签
    tab_widget.addTab(QWidget(), "标签1")
    tab_widget.addTab(QWidget(), "标签2")
    tab_widget.addTab(QWidget(), "标签3")
    # 分别设置不同背景色
    custom_tab_bar.setTabBackgroundColor(0, "#ffcccc") # 浅红
    custom_tab_bar.setTabBackgroundColor(1, "#ccffcc") # 浅绿
    custom_tab_bar.setTabBackgroundColor(2, "#ccccff") # 浅蓝
    tab_widget.show()
    sys.exit(app.exec_())

如果需要区分悬浮、选中等状态的背景色，可在paintEvent中通过self.currentIndex() == index、self.underMouse()等方法判断状态，对应设置不同颜色即可。

方案2：QSS样式表实现（适合标签数量固定场景） #

如果tab数量固定无需动态增删，可直接用QSS的nth-child选择器实现，无需自定义类，代码更简洁：

# 直接给QTabWidget设置样式表即可，nth-child序号从1开始计数，和tab索引差1
tab_widget.setStyleSheet("""
    QTabBar::tab:nth-child(1) {
        background-color: #ffcccc;
    }
    QTabBar::tab:nth-child(2) {
        background-color: #ccffcc;
    }
    QTabBar::tab:nth-child(3) {
        background-color: #ccccff;
    }
    /* 可选：设置选中态样式，避免和默认选中色冲突 */
    QTabBar::tab:selected {
        border-bottom: 2px solid #333333;
    }
""")

注意如果后续有增删tab的需求，需要手动同步更新QSS中的对应规则。

内容的提问来源于stack exchange，提问作者Kamil.Khoury