如何用Pandas将字典转CSV且仅保留单个表头

核心思路是通过检查目标CSV文件是否存在，动态决定是否写入表头：文件不存在时（首次写入）添加表头，文件已存在时（后续追加）跳过表头。

实现代码 #

首先导入必要模块：

import pandas as pd
import os

定义一个可复用的追加函数，处理单条字典数据：

def append_dict_to_csv(data_dict, csv_path):
    # 将字典转为单行DataFrame
    df = pd.DataFrame([data_dict])
    # 检查文件是否已存在
    file_exists = os.path.exists(csv_path)
    # 写入CSV：mode设为追加，index=False避免存储多余索引列，header根据文件状态动态设置
    df.to_csv(
        csv_path,
        mode='a',
        index=False,
        header=not file_exists  # 文件不存在时写表头，存在时不写
    )

使用示例 #

# 首次写入数据
data1 = {"a": 1, "c": 2, "d": 3}
append_dict_to_csv(data1, "output.csv")

# 后续追加数据（自动跳过表头）
data2 = {"a": 4, "c": 5, "d": 6}
append_dict_to_csv(data2, "output.csv")

data3 = {"a": 7, "c": 8, "d": 9}
append_dict_to_csv(data3, "output.csv")

关键说明 #

• 借助os.path.exists()自动判断文件状态，无需额外标记是否为第一条数据。
• 设置index=False避免CSV中出现多余的索引列（原代码里的index=[0]会导致存储无用索引，建议移除）。
• header=not file_exists是核心逻辑：文件不存在时触发表头写入，已存在时直接跳过表头，完美解决重复问题。

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