Pandas导出文件时如何在列名上方添加自定义文本行

你可以通过先写入自定义头部、再追加DataFrame内容的方式实现需求，完整代码如下：

import pandas as pd

# --------------- 以下是构造示例DataFrame的代码，你可以替换为自己的df ---------------
data = {
    "5": [
        "2014-01-01 00:00:00",
        "2014-01-01 00:15:00",
        "2014-01-01 00:30:00",
        "2014-01-01 00:45:00",
        "2014-01-01 01:00:00"
    ],
    "Value": [2.80, 2.97, 2.74, 2.54, 2.28]
}
df = pd.DataFrame(data)
# -----------------------------------------------------------------------------

# 自定义需要添加的头部内容
custom_header = [
    "$Column1=Time (days)",
    "$Column2=Temperature (°C)"
]

# 导出文件路径，后缀改为.dat即可保存为dat格式
save_path = "output.csv"

# 写入文件
with open(save_path, "w", encoding="utf-8") as f:
    # 先写入自定义头部行
    for line in custom_header:
        f.write(f"{line}\n")
    # 追加写入DataFrame内容，保留原列名、不导出索引
    df.to_csv(
        f,
        sep="\t",  # 可根据需求修改分隔符，空格分隔改为sep=" "，逗号分隔改为sep=","
        index=False,
        header=True,
        encoding="utf-8",
        float_format="%.2f"  # 保证Value列保留两位小数，和示例格式一致
    )

注意事项 #

• 该方法不会修改原DataFrame的结构，也不会影响原有数据的导出格式
• 编码指定为utf-8可避免温度单位°C出现乱码，如有其他编码需求可自行调整
• 如果时间列本身是datetime类型，无需手动转字符串，pandas导出时会自动保持你需要的时间格式

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