不能只靠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()导出超大数据量时卡顿或内存爆掉怎么办？
openpyxl 是内存型操作，逐单元格写入；如果单表超过 5 万行 × 20 列，直接 to_excel() 容易 OOM 或耗时超 2 分钟。这时候得绕开 pandas 的封装，用 openpyxl 原生 API 批量写入。
立即学习“Python免费学习笔记（深入）”；
- 用
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 等冷门属性硬调。
