PyQt6中如何保留QT Designer设置的表头文本并设置表头颜色？

我是编程新手，刚用PyQt6和QT Designer做界面，现在有个180列的QTableWidget，已经实现按分组隐藏列的功能。想给不同分组的表头设特定颜色（比如0-10列蓝色，11-20列红色），而且要保留QT Designer里设置的表头文本。

我试过这段代码：

item1 = QtWidgets.QTableWidgetItem()   
item1.setBackground(QtGui.QColor(255, 0, 0))
self.table.setHorizontalHeaderItem(0,item1)

但这段代码会覆盖原来的表头文本，而且颜色也没改成功。找到的参考示例都是重新设置表头文本的，想问怎么在不覆盖原有文本的前提下设置表头颜色？

参考示例代码：

import sys
from PyQt6 import QtGui, QtWidgets

class MyFrame(QtWidgets.QFrame):
    def __init__(self, parent=None,initials=None):
        QtWidgets.QFrame.__init__(self, parent)
        self.table = QtWidgets.QTableWidget(5,3,self)
        self.table.move(30,30)
        self.table.resize(400,300)

        item1 = QtWidgets.QTableWidgetItem('red')
        item1.setBackground(QtGui.QColor(255, 0, 0))
        self.table.setHorizontalHeaderItem(0,item1)

        item2 = QtWidgets.QTableWidgetItem("green")
        item2.setBackground(QtGui.QColor(0, 255, 0))
        self.table.setHorizontalHeaderItem(1,item2)

        item3 = QtWidgets.QTableWidgetItem('blue')
        item3.setBackground(QtGui.QColor(0, 0, 255))
        self.table.setHorizontalHeaderItem(2,item3)

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    app.setStyle(QtWidgets.QStyleFactory.create('Fusion')) # won't work on windows style.
    Frame = MyFrame(None)
    Frame.resize(500,400)
    Frame.show()
    app.exec()

你之前的问题核心是新建空的QTableWidgetItem替换了原有表头项，所以覆盖了文本。正确的做法是直接获取已存在的表头项，修改它的背景色即可，无需替换整个item。另外注意：Windows默认样式会忽略表头背景色设置，得切换到支持自定义样式的风格（比如Fusion）。

实现代码 #

from PyQt6 import QtGui, QtWidgets

# 在你的UI类初始化或setupUi完成后调用这个方法
def set_header_colors(self):
    # 设置样式风格，确保背景色生效
    QtWidgets.QApplication.setStyle(QtWidgets.QStyleFactory.create('Fusion'))

    # 定义分组规则：列范围 -> 对应颜色
    color_groups = [
        (range(0, 11), QtGui.QColor(0, 0, 255)),   # 0-10列设为蓝色
        (range(11, 21), QtGui.QColor(255, 0, 0))   # 11-20列设为红色
    ]

    for col_range, color in color_groups:
        for col in col_range:
            # 获取QT Designer中已存在的表头项，不新建空item
            header_item = self.table.horizontalHeaderItem(col)
            if header_item:  # 避免列索引越界导致报错
                header_item.setBackground(color)

代码说明 #

1. 保留原有文本：用horizontalHeaderItem(col)直接拿到QT Designer里设置好文本的表头项，修改属性不会覆盖原有内容。
2. 样式兼容：切换到Fusion风格解决Windows原生样式不支持表头背景色的问题。
3. 批量分组设置：通过列范围和颜色的映射列表，能快速给180列按分组设置颜色，不用逐个列编写重复代码。

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