如何向XLSX模板追加列表数据并实现动态列逻辑？

核心需求 #

• 向已有表头的XLSX模板追加数据行
• 当新增数据中的Description条目数超过现有表头的Description列数量时，自动创建对应序号的Description 序号列
• 后续迭代追加时，自动适配当前Description的数量扩展列

原代码问题分析 #

• 新增数据的结构与现有表头不匹配，导致合并后数据错位
• 未实现动态检测并新增Description列的逻辑
• 使用overlay模式直接覆盖可能破坏原有表头和数据结构

修正后完整代码 #

import pandas as pd

xlsx_file = "input.xlsx"

# 1. 读取现有Excel数据，获取表头
df = pd.read_excel(xlsx_file)
existing_cols = df.columns.tolist()

# 2. 提取现有表头中的Description列，计算当前最大序号
desc_cols = [col for col in existing_cols if col.startswith("Description ")]
max_existing_desc_num = max([int(col.split(" ")[1]) for col in desc_cols]) if desc_cols else 0

# 3. 准备新增数据（示例）
new_brand = "Brand A"
new_title = "Product Title"
new_descriptions = ["Description 1", "Description 2", "Description 3", "Description 4", "Description 5"]  # 超过4个的情况
new_quantity = "Quantity 5"

# 4. 计算需要新增的Description列
needed_desc_num = len(new_descriptions)
if needed_desc_num > max_existing_desc_num:
    new_desc_cols = [f"Description {i}" for i in range(max_existing_desc_num + 1, needed_desc_num + 1)]
    # 向现有数据中新增列，填充空值
    for col in new_desc_cols:
        df[col] = pd.NA
    existing_cols += new_desc_cols

# 5. 整理新增数据为匹配表头的行
new_row = {}
new_row["Brand"] = new_brand
new_row["Product Title"] = new_title
# 填充对应序号的Description列
for idx, desc in enumerate(new_descriptions, 1):
    new_row[f"Description {idx}"] = desc
new_row["Quantity"] = new_quantity

# 6. 补充表头中其他空缺列的空值
for col in existing_cols:
    if col not in new_row:
        new_row[col] = pd.NA

# 7. 将新行追加到原有数据
df = pd.concat([df, pd.DataFrame([new_row])], ignore_index=True)

# 8. 写入Excel，覆盖原有文件（新增列后用w模式更稳妥）
with pd.ExcelWriter(xlsx_file, engine='openpyxl') as writer:
    df.to_excel(writer, index=False)

关键逻辑说明 #

• 动态列检测：通过筛选表头中以Description 开头的列，计算当前已有的最大序号，判断是否需要新增列
• 列扩展：当新增的Description数量超过现有列数时，自动生成新列名并添加到数据中
• 数据对齐：将新增数据按表头列名逐一匹配，确保每个字段对应正确的列，空缺字段用pd.NA填充
• 安全写入：使用默认的mode='w'覆盖原有文件，避免overlay模式可能导致的表头或数据错位问题

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