如何在Python Pandas DataFrame表头上方添加行（无本地文件读写）

需要在Pandas DataFrame转换生成的Excel文件表头上方添加一行，禁止本地文件读写（无法使用open('filename.xls', 'w') as f:这类代码），脚本运行在无本地文件读写权限的环境中。

期望的Excel内容效果：

text here
animal  no_of_legs  name
cat     4           meow
bird    2           chirp
rabbit  2           bun

现有数据存储在数组allAnimals中，尝试过两种方法均未达到预期：

• 向数组插入行再转DataFrame：执行allAnimals.insert(0,['text here'])后转DataFrame，导出后该行出现在表头下方
• 创建单行DataFrame合并：用concat或append合并仅含'text here'的DataFrame，结果新增列而非横向添加标题行

可以通过pandas.ExcelWriter结合内存缓冲区（如io.BytesIO），直接在Excel工作表指定位置写入标题行，再写入DataFrame数据，全程无需本地文件操作：

基础实现代码 #

import pandas as pd
import io

# 示例数据数组
allAnimals = [
    ['cat', 4, 'meow'],
    ['bird', 2, 'chirp'],
    ['rabbit', 2, 'bun']
]

# 1. 转换为标准DataFrame
df = pd.DataFrame(allAnimals, columns=['animal', 'no_of_legs', 'name'])

# 2. 创建内存缓冲区替代本地文件
output = io.BytesIO()

# 3. 写入Excel内容
with pd.ExcelWriter(output, engine='xlsxwriter') as writer:
    worksheet = writer.sheets['Sheet1']
    # 在第1行（索引0）写入标题
    worksheet.write_string(0, 0, 'text here')
    # 从第2行（索引1）开始写入DataFrame，表头自动跟随
    df.to_excel(writer, sheet_name='Sheet1', startrow=1, index=False)

# 内存缓冲区output中已存储完整Excel数据，可用于后续传输、上传等操作
# 如需读取内容可使用 output.getvalue()

优化：标题跨列居中 #

如果需要标题跨所有数据列居中显示，可替换标题写入代码：

# 合并第1行的所有数据列，写入居中标题
worksheet.merge_range(0, 0, 0, len(df.columns)-1, 'text here', {'align': 'center', 'valign': 'vcenter'})

内容的提问来源于Stack Exchange，提问作者MatCode