Python如何在CSV首尾插入指定序列并将DataFrame数据下移一行

• 最终输出的CSV文件需在头部、尾部位置包含预先指定的序列
• 原DataFrame的所有数据需整体向下偏移1行
• 此前使用Python的ExcelWriter写入头尾部序列后再转换为CSV的方案无法正常生效，需要可稳定实现需求的Python代码

放弃Excel中转转CSV的思路，直接按文本拼接逻辑生成CSV，避免格式兼容问题：

1. 先将DataFrame转换为CSV格式的文本内容，暂存到内存不直接写入磁盘
2. 按顺序拼接最终文件内容：头部指定序列 → 对应偏移量的空行 → DataFrame的CSV内容 → 尾部指定序列
3. 将拼接完成的完整内容直接写入目标CSV文件，全程不依赖Excel格式读写

import pandas as pd
from io import StringIO

def export_csv_with_header_footer(
    df: pd.DataFrame,
    output_path: str,
    header_seq: str,
    footer_seq: str,
    df_offset_rows: int = 1,
    encoding: str = "utf-8-sig"
):
    """
    导出带自定义页眉、页脚的CSV
    :param df: 原数据DataFrame
    :param output_path: 最终导出的CSV文件路径
    :param header_seq: 头部需要插入的指定序列字符串
    :param footer_seq: 尾部需要插入的指定序列字符串
    :param df_offset_rows: 页眉和DataFrame内容之间的空行数，默认1行，实现数据整体下移效果
    :param encoding: 文件编码，默认utf-8-sig适配Excel打开不乱码
    """
    # 将DataFrame转为CSV格式文本
    df_csv_buffer = StringIO()
    df.to_csv(df_csv_buffer, index=False)
    df_content = df_csv_buffer.getvalue()

    # 拼接全量内容
    offset_blank = "\n" * df_offset_rows
    full_content = f"{header_seq}\n{offset_blank}{df_content}{footer_seq}\n"

    # 写入文件
    with open(output_path, "w", encoding=encoding) as f:
        f.write(full_content)

# 调用示例
if __name__ == "__main__":
    # 测试用原始DataFrame
    test_df = pd.DataFrame({
        "列1": ["数据1", "数据2", "数据3"],
        "列2": [100, 200, 300],
        "列3": ["A", "B", "C"]
    })
    # 自定义头、尾序列
    custom_header = "===== 头部指定序列 ====="
    custom_footer = "===== 尾部指定序列 ====="
    # 执行导出
    export_csv_with_header_footer(
        df=test_df,
        output_path="./导出结果.csv",
        header_seq=custom_header,
        footer_seq=custom_footer
    )

• 如果头/尾部序列本身包含换行，直接传入带换行符的字符串即可，代码会自动按格式排版
• 如果需要头部序列和DataFrame内容之间没有空行，只需要把df_offset_rows参数设为0，此时DataFrame紧挨头部序列下一行放置，相对无页眉的场景正好下移1行
• 默认使用utf-8-sig编码是为了避免Excel直接打开CSV时出现中文乱码，有特殊编码需求可自行修改encoding参数

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