如何在Python中导出带Caption标题的DataFrame至Excel文件

问题出在df.style.set_caption()生成的标题仅适用于HTML渲染场景，无法直接通过to_excel()导出到Excel文件。要实现Excel中显示标题，需要借助xlsxwriter引擎的工作表对象手动添加标题，以下是两种可行方案：

方案一：基础版 - 手动添加标题 #

import pandas as pd

data={'Name':['Karan','Rohit','Sahil','Aryan'],'Age':[23,22,21,24]}
df=pd.DataFrame(data)

# 创建Excel写入器
with pd.ExcelWriter("output.xlsx", engine='xlsxwriter') as writer:
    # 让DataFrame从第2行开始写入，预留标题行
    df.to_excel(writer, sheet_name='Sheet1', index=False, startrow=1)
    
    # 获取目标工作表对象
    worksheet = writer.sheets['Sheet1']
    
    # 写入标题文本
    worksheet.write('A1', 'This is caption')
    
    # 可选：给标题添加格式（加粗+大号字体）
    bold_title = writer.book.add_format({'bold': True, 'font_size': 14})
    worksheet.write('A1', 'This is caption', bold_title)
    
    # 可选：调整列宽适配内容
    worksheet.set_column('A:B', 15)

方案二：进阶版 - 保留Styler格式+跨列标题 #

如果需要保留DataFrame的样式设置，同时让标题跨列居中显示，可以用以下方式：

import pandas as pd

data={'Name':['Karan','Rohit','Sahil','Aryan'],'Age':[23,22,21,24]}
df=pd.DataFrame(data)

# 创建带格式的Styler对象（隐藏索引）
styled_df = df.style.hide(axis='index')

with pd.ExcelWriter("output.xlsx", engine='xlsxwriter') as writer:
    # 导出带样式的DataFrame，从第2行开始
    styled_df.to_excel(writer, sheet_name='Sheet1', startrow=1)
    
    worksheet = writer.sheets['Sheet1']
    workbook = writer.book
    
    # 定义标题格式：加粗、居中、大号字体
    title_format = workbook.add_format({'bold': True, 'font_size': 14, 'align': 'center'})
    # 跨A、B列合并单元格并写入标题
    worksheet.merge_range('A1:B1', 'This is caption', title_format)
    
    # 调整列宽
    worksheet.set_column('A:B', 15)

核心要点 #

• 使用startrow=1参数预留出标题行，避免DataFrame覆盖标题
• merge_range方法可以实现标题跨列居中，提升视觉效果
• 所有格式设置基于xlsxwriter的格式对象，可根据需求自定义样式

内容的提问来源于stack exchange，提问作者k r harsha