如何用Pandas DataFrame写入多行表头Excel并规避空列？

我明白你要实现的是把包含重复列组的DataFrame写入Excel，设置重复的多行表头（比如A/B/C/D/E重复多次），同时避免转换时自动生成空列。下面结合你提到的测试数据（a到y列，行1全1、行2全2等），给你具体的解决方案：

步骤1：构建带多层表头的DataFrame #

首先我们需要用Pandas的MultiIndex（多层索引）来定义重复的表头结构，把原始数据列和重复的表头组对应起来：

import pandas as pd

# 1. 创建你提到的测试数据：列a到y，3行数据
cols = [chr(ord('a') + i) for i in range(25)]  # 生成a到y的列名
data = [[1]*25, [2]*25, [3]*25]
df = pd.DataFrame(data, columns=cols)

# 2. 构建重复的多层表头：上层是重复的A-E，下层是原始列名a-y
# 这里A-E重复5次（对应25列=5组×5列），如果需要重复3次就改成*3，同时取前15列即可
header_top = ['A', 'B', 'C', 'D', 'E'] * 5
header_bottom = cols

# 把两层表头组合成MultiIndex，作为DataFrame的列索引
df.columns = pd.MultiIndex.from_arrays(
    [header_top, header_bottom],
    names=['Group', 'Column']  # 可选：给每层表头命名
)

步骤2：写入Excel并避免空列 #

接下来用xlsxwriter引擎写入Excel，这个引擎能完美支持多层表头的渲染，不会产生空列。如果需要自定义表头格式（比如加粗、居中），也可以轻松实现：

# 确保先安装xlsxwriter：pip install xlsxwriter
with pd.ExcelWriter('multi_header_result.xlsx', engine='xlsxwriter') as writer:
    # 写入DataFrame，不要包含行索引
    df.to_excel(writer, index=False)
    
    # 可选：自定义表头格式（加粗+居中）
    workbook = writer.book
    worksheet = writer.sheets['Sheet1']
    header_format = workbook.add_format({'bold': True, 'align': 'center'})
    
    # 把格式应用到两层表头
    for col_num, value in enumerate(df.columns.get_level_values(0)):
        worksheet.write(0, col_num, value, header_format)
    for col_num, value in enumerate(df.columns.get_level_values(1)):
        worksheet.write(1, col_num, value, header_format)
    
    # 自动调整列宽，避免内容截断
    for col_num in range(len(df.columns)):
        worksheet.set_column(col_num, col_num, 10)

为什么之前的尝试可能失败？ #

如果你之前手动拼接表头或者用了错误的索引构造方式，很容易导致Pandas在写入Excel时生成空列。而用MultiIndex来定义多层表头是Pandas官方推荐的标准方式，配合xlsxwriter引擎可以确保表头正确渲染，不会出现多余的空列。

额外注意事项 #

• 如果你的需求是A-E重复3次（对应15列），只需要修改header_top = ['A','B','C','D','E']*3，同时原始列取前15列即可；
• 如果你不需要自定义格式，直接调用df.to_excel('result.xlsx', index=False)也能正确显示多层表头；
• 如果你习惯用openpyxl引擎，也可以替换，但xlsxwriter在格式控制上更灵活。

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