如何在导出Pandas DataFrame到Excel时在顶部添加元信息区域？

核心思路是结合pandas与Excel写入引擎（如openpyxl），先在工作表上方区域写入元信息，再指定DataFrame的起始写入行，从而留出空白区域。这种方法无需额外修改已导出的Excel文件，一步完成操作，效率和灵活性都很高。

具体实现步骤（以openpyxl为例） #

1. 先安装依赖包：

pip install pandas openpyxl

2. 完整代码示例：

import pandas as pd
from openpyxl import Workbook
from openpyxl.styles import Font

# 准备目标DataFrame
df = pd.DataFrame({'col1': [1, 2]})

# 定义需要添加的元信息
meta_data = [
    ["数据版本: v1.0", None],
    ["导出日期: 2024-05-20", None],
    ["数据说明: 示例测试数据", None]
]

# 创建Excel工作簿和工作表
wb = Workbook()
ws = wb.active

# 写入元信息，并设置加粗样式
bold_font = Font(bold=True)
for idx, row in enumerate(meta_data, start=1):
    ws.append(row)
    ws[f"A{idx}"].font = bold_font

# 将DataFrame从第5行开始写入（留出3行空白）
start_row = 5
df.to_excel(wb, sheet_name="Sheet1", startrow=start_row-1, index=False)

# 保存文件
wb.save("abc.xlsx")

关键说明 #

• startrow参数：控制DataFrame的起始写入行（索引从0开始，所以要减1对应Excel的行号），通过调整这个值可以灵活控制空白区域的大小。
• 样式自定义：利用openpyxl的样式模块可以给元信息设置字体、颜色、对齐方式等，完全匹配你需要的展示效果。
• 若使用xlsxwriter引擎，逻辑类似：先创建工作簿写入元信息，再用startrow参数写入DataFrame，只是样式设置的API略有不同。

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