不能只靠pandas.to_excel()导出多工作表,因为它默认用xlsxwriter引擎,不支持读/改已有文件,会清空原有样式、公式、图表和合并单元格;若需保留模板格式,必须用openpyxl引擎配合load_workbook加载模板并复用workbook对象。

用 pandas + openpyxl 是当前最稳妥、可控性最强的方案,别用 xlsxwriter 处理已有样式或公式依赖的多表导出。
为什么不能只靠 pandas.to_excel() 导出多工作表?
pandas.to_excel() 默认使用 xlsxwriter 引擎,它不支持读取/修改已有 Excel 文件,也不能保留已有工作表的格式、图表、数据验证或公式——一旦你调用 ExcelWriter 并写入多个 sheet_name,所有内容都是“全新生成”的,老表里的合并单元格、条件格式全丢。
- 如果你只是导出纯数据报表(无样式、无公式),
to_excel()配合ExcelWriter足够快且简洁 - 但只要涉及“在模板上填数”“保留汇总页格式”“写入带公式的计算表”,就必须切换到
openpyxl作为引擎 -
openpyxl支持读-改-写全流程,但性能略低,尤其在写入大量单元格时需注意优化方式
如何用 openpyxl 引擎写入多个工作表并保持格式?
关键不是“怎么写”,而是“怎么避免覆盖模板原有结构”。必须显式打开原文件,再用 ExcelWriter 的 engine_kwargs 告诉它复用已加载的工作簿。
- 先用
openpyxl.load_workbook()加载模板文件(含多个预设格式的工作表) - 创建
pd.ExcelWriter时传入engine="openpyxl"和engine_kwargs={"workbook": wb},其中wb是刚才加载的Workbook对象 - 对每个目标工作表,用
df.to_excel(writer, sheet_name="xxx", index=False)——注意:这会清空该表全部内容,但保留其所在工作表对象的样式、页眉页脚等元信息 - 最后调用
writer.close(),而非save(),否则会触发二次序列化,可能损坏公式引用
import pandas as pd
from openpyxl import load_workbook
<p>wb = load_workbook("report_template.xlsx")
with pd.ExcelWriter("output.xlsx", engine="openpyxl", engine_kwargs={"workbook": wb}) as writer:
df_summary.to_excel(writer, sheet_name="Summary", index=False)
df_detail.to_excel(writer, sheet_name="Detail", index=False)</p><h1>注意:不调用 wb.save(),也不调用 writer.save()</h1>
导出超大数据量时卡顿或内存爆掉怎么办?
openpyxl 是内存型操作,逐单元格写入;如果单表超过 5 万行 × 20 列,直接 to_excel() 容易 OOM 或耗时超 2 分钟。这时候得绕开 pandas 的封装,用 openpyxl 原生 API 批量写入。
- 用
ws.append()替代df.to_excel(),把df.values.tolist()拆成批次(如每 5000 行 flush 一次) - 关闭自动计算:
wb.calculation_mode = "manual",写完再设回"auto" - 禁用网格线和自动筛选(除非真需要):
ws.sheet_view.showGridLines = False - 避免在循环里反复调用
ws.cell().value = ...,它比ws.append()慢 3–5 倍
常见报错 ValueError: This workbook contains no default style, unable to create a new cell 怎么办?
这是 openpyxl 在处理某些老旧 Excel 模板(尤其是从 WPS 或旧版 Excel 导出的 .xlsx)时,缺失默认 CellStyle 引起的。不是代码写错了,是模板坏了。
- 最简解法:用 Excel 打开模板 → 另存为 → 选“Excel 工作簿 (*.xlsx)” → 关闭 → 再用 Python 处理
- 程序化解法:在
load_workbook()后加一行wb.add_named_style(...)补一个空样式(但不如手动另存稳定) - 如果模板来自用户上传,建议在服务端加校验:尝试
load_workbook(filename, read_only=True),捕获异常后提示“请用 Excel 重新保存该模板”
真正麻烦的从来不是“怎么写多张表”,而是“怎么让第 3 张表里的图表自动更新数据源”“怎么保证 VLOOKUP 公式跨表引用不崩”——这些细节没文档可抄,只能靠反复打开 Excel 查看 Formula 层级和 openpyxl 的 ws.defined_names、ws.formula_attributes 等冷门属性硬调。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











