如何在QTreeWidget中实现表头列合并及可展开子列结构？

完全可以仅用QTreeWidget实现需求，不需要额外嵌入表格部件，核心是利用QTreeWidgetItem.setSpan()方法实现列合并，配合树形结构的展开/折叠特性即可。

核心思路 #

• 将QTreeWidget设置为目标子列数（这里是4列）
• 每个Record主项作为顶层item，通过setSpan()合并所有列，实现单行表头的视觉效果
• 主项下方添加子item：先设置子列的表头行，再添加数据行，利用QTreeWidget原生的展开/折叠功能控制显示

具体实现代码（PyQt5示例） #

from PyQt5.QtWidgets import QApplication, QTreeWidget, QTreeWidgetItem, QFont
import sys

app = QApplication(sys.argv)

# 初始化QTreeWidget
tree_widget = QTreeWidget()
tree_widget.setColumnCount(4)
tree_widget.setHeaderHidden(True)  # 隐藏默认顶层表头，用Record项作为分组表头

# --------------------- 创建第一个分组：Record N1 ---------------------
record_item1 = QTreeWidgetItem(tree_widget)
record_item1.setText(0, "Record N1")
# 合并当前item的第0列到第3列（共4列），实现跨列单行表头
record_item1.setSpan(0, 0, 1, tree_widget.columnCount())
# 设置可展开，默认展开
record_item1.setExpanded(True)
# 可选：设置分组表头样式，比如加粗放大
record_font = QFont()
record_font.setBold(True)
record_font.setPointSize(11)
record_item1.setFont(0, record_font)

# 添加子列表头
sub_header1 = QTreeWidgetItem(record_item1)
sub_header1.setText(0, "Col1")
sub_header1.setText(1, "Col2")
sub_header1.setText(2, "Col3")
sub_header1.setText(3, "Col4")
# 可选：设置子表头样式
header_font = QFont()
header_font.setBold(True)
sub_header1.setFont(0, header_font)
sub_header1.setFont(1, header_font)
sub_header1.setFont(2, header_font)
sub_header1.setFont(3, header_font)

# 添加数据行
data_row1 = QTreeWidgetItem(record_item1)
data_row1.setText(0, "Data1-1")
data_row1.setText(1, "Data1-2")
data_row1.setText(2, "Data1-3")
data_row1.setText(3, "Data1-4")

data_row2 = QTreeWidgetItem(record_item1)
data_row2.setText(0, "Data2-1")
data_row2.setText(1, "Data2-2")
data_row2.setText(2, "Data2-3")
data_row2.setText(3, "Data2-4")

# --------------------- 创建第二个分组：Record N2 ---------------------
record_item2 = QTreeWidgetItem(tree_widget)
record_item2.setText(0, "Record N2")
record_item2.setSpan(0, 0, 1, tree_widget.columnCount())
record_item2.setFont(0, record_font)

sub_header2 = QTreeWidgetItem(record_item2)
sub_header2.setText(0, "Col1")
sub_header2.setText(1, "Col2")
sub_header2.setText(2, "Col3")
sub_header2.setText(3, "Col4")
sub_header2.setFont(0, header_font)
sub_header2.setFont(1, header_font)
sub_header2.setFont(2, header_font)
sub_header2.setFont(3, header_font)

data_row3 = QTreeWidgetItem(record_item2)
data_row3.setText(0, "Data3-1")
data_row3.setText(1, "Data3-2")
data_row3.setText(2, "Data3-3")
data_row3.setText(3, "Data3-4")

tree_widget.resize(600, 400)
tree_widget.show()
sys.exit(app.exec_())

关键细节说明 #

• setSpan(row, column, row_span, column_span)：对Record项调用时，row=0（item自身所在行），column=0（起始列），row_span=1（只占一行），column_span=4（跨4列），直接实现列合并效果
• 隐藏QTreeWidget的默认表头，避免和自定义的分组表头冲突
• 子项的表头和数据行都是普通QTreeWidgetItem，仅通过样式区分，逻辑简单，维护成本低
• 完全利用QTreeWidget原生的展开/折叠功能，不需要额外编写事件处理代码

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