如何将多个独立Pandas DataFrame导出至单个CSV并插入说明文字？

CSV本质是纯文本格式，完全可以通过Python文件操作+Pandas的to_csv方法组合实现需求，不用合并DataFrame，还能自由插入说明文字。

具体实现步骤 #

直接通过文件句柄分批次写入内容：先写说明文字，再写第一个DataFrame，接着插入中间说明，最后写入第二个DataFrame。

代码示例 #

import pandas as pd

# 示例DataFrame（替换成你的实际数据）
df1 = pd.DataFrame({'用户ID': [1001, 1002, 1003], '消费金额': [299, 599, 129]})
df2 = pd.DataFrame({'商品分类': ['数码', '服饰'], '库存数量': [150, 300], '上月销量': [80, 120]})

# 打开目标CSV文件，用with语句自动管理文件资源
with open('合并结果.csv', 'w', newline='', encoding='utf-8') as f:
    # 写入开头说明（可选）
    f.write('数据导出时间：2024-05-20\n\n')
    
    # 写入第一个DataFrame
    f.write('### 第一部分：用户消费数据\n')
    df1.to_csv(f, index=False)
    
    # 插入中间说明文字，支持多行
    f.write('\n---\n')
    f.write('注意：以下商品库存数据与上方用户数据无关联，为独立统计项\n')
    f.write('统计范围：全平台线下门店\n\n')
    
    # 写入第二个DataFrame
    f.write('### 第二部分：商品库存数据\n')
    df2.to_csv(f, index=False)

关键细节说明 #

• newline=''：避免Windows系统下写入时出现多余空行，保证格式整洁
• encoding='utf-8'：确保中文说明文字在Excel或其他工具中正常显示
• Pandas的to_csv方法支持直接传入文件句柄，会自动把DataFrame的表头和数据按CSV格式写入，不会和手动写入的文本冲突
• 如果DataFrame包含逗号、引号等特殊字符，to_csv会自动用引号包裹字段，避免CSV格式混乱

用Excel打开生成的文件时，说明文字会作为普通单元格内容显示，两个DataFrame会各自形成独立的表格区域，完全符合需求。

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