向含图表的现有Excel文件新增工作表时遇ValueError问题求助

错误原因 #

当Excel文件包含图表、切片器等复杂元素时，直接将load_workbook加载的工作簿赋值给writer.book，pandas在解析工作表结构时会遇到未兼容的元素类型，触发ValueError: Value must be one of ['field', 'data', 'selection']错误。

修正方案 #

使用追加模式初始化ExcelWriter，并手动同步现有工作表，避免破坏原有图表结构：

import pandas as pd
import numpy as np
from openpyxl import load_workbook

path = r"C:\Users\fedel\Desktop\excelData\PhD_data.xlsx"

# 加载现有工作簿（确保可读写）
book = load_workbook(path)

# 用with语句管理ExcelWriter，自动处理文件关闭
with pd.ExcelWriter(
    path,
    engine='openpyxl',
    mode='a',  # 追加模式，保留原有内容
    if_sheet_exists='replace'  # 若目标工作表已存在则替换，可选值：error/new
) as writer:
    # 同步现有工作表到writer，避免pandas重新解析时破坏图表
    writer.sheets = {ws.title: ws for ws in book.worksheets}
    
    # 生成测试数据
    x3 = np.random.randn(100, 2)
    df3 = pd.DataFrame(x3)
    
    x4 = np.random.randn(100, 2)
    df4 = pd.DataFrame(x4)
    
    # 写入新工作表
    df3.to_excel(writer, sheet_name='x3')
    df4.to_excel(writer, sheet_name='x4')

关键说明 #

• mode='a'：以追加模式打开文件，确保原有数据和图表不会被覆盖
• if_sheet_exists：控制已存在工作表的处理逻辑，根据需求选择error（报错）、new（重命名新表）或replace（替换）
• writer.sheets同步：手动映射现有工作表，避免pandas初始化时破坏原有复杂元素的结构

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