本文详解如何使用 pandas 的 `excelwriter`（配合 `openpyxl` 引擎）将多个 dataframe 分别写入同一 excel 文件的多个独立工作表，避免覆盖问题，并提供完整可运行示例与关键注意事项。
在实际数据处理流程中，常需将来自不同模块或程序的多个 DataFrame 汇总到一个 Excel 工作簿中，每个 DataFrame 占据独立的工作表（如 'Sheet1', 'Sheet2', 'JAron', 'Bloomberg' 等）。但若直接多次调用 pd.ExcelWriter 且未正确配置模式（mode）和引擎（engine），极易导致前序写入内容被覆盖——尤其当默认使用 xlsxwriter 时，其不支持追加（append）模式，会直接报错 ValueError: Append mode is not supported with xlsxwriter!。
✅ 正确解法是：统一使用 openpyxl 引擎 + mode='a'（append 模式） + 显式指定各 sheet_name。openpyxl 支持对已存在 .xlsx 文件进行追加写入，且可通过 if_sheet_exists 参数灵活控制同名工作表行为（如 'replace'、'overlay' 或 'new'）。
✅ 推荐实现方式（单次集中写入，最安全）
最佳实践是避免多进程/多脚本并发写入同一文件，而是将全部 DataFrame 整合后一次性写入。例如：
import pandas as pd
# 假设你有 4 个 DataFrame，分别来自不同程序
df_jaron = pd.DataFrame({"A": [1, 2], "B": ["x", "y"]})
df_bbg = pd.DataFrame({"C": [3, 4], "D": ["m", "n"]})
df_ref = pd.DataFrame({"E": [5], "F": ["z"]})
df_risk = pd.DataFrame({"G": [6, 7, 8], "H": ["p", "q", "r"]})
# 所有 df 与对应 sheet 名称映射
sheets_to_write = {
"JAron": df_jaron,
"Bloomberg": df_bbg,
"Reference": df_ref,
"RiskMetrics": df_risk
}
output_path = r"Y:\HedgeFundRecon\JAron\Output\JAronOutput.xlsx"
# 一次性写入所有 sheet（自动创建新文件或覆盖已有同名 sheet）
with pd.ExcelWriter(output_path, engine="openpyxl",
datetime_format="mm/dd/yy",
date_format="mm/dd/yy") as writer:
for sheet_name, df in sheets_to_write.items():
df.to_excel(writer, sheet_name=sheet_name, index=False)? 提示：index=False 可避免写入行索引，提升可读性；datetime_format 和 date_format 统一控制时间列显示格式。
⚠️ 若必须分步写入（如多脚本协同），请严格注意：
- 必须指定 engine='openpyxl'（xlsxwriter 不支持 mode='a'）；
- 安装依赖：pip install openpyxl；
- 禁止并发写入：多个 Python 进程同时打开并写入同一 .xlsx 文件将引发异常或损坏文件；
- mode='a' 是关键：它表示“追加到现有工作簿”，而非覆盖整个文件；
- if_sheet_exists='replace'（默认值）会在 sheet 已存在时先删除再重建，确保内容纯净；若需保留原 sheet 中非写入区域内容，可选 'overlay'（但需精确控制 startrow/startcol）。
示例（分步写入单个 sheet，适用于脚本化场景）：
import pandas as pd
import os
path = r"Y:\HedgeFundRecon\JAron\Output\JAronOutput.xlsx"
df_list = [df_jaron, df_bbg] # 示例数据列表
# 确保文件存在（首次写入用 'w' 模式创建）
if not os.path.exists(path):
with pd.ExcelWriter(path, engine="openpyxl", mode="w") as writer:
pd.DataFrame().to_excel(writer, sheet_name="placeholder", index=False) # 占位
# 后续追加写入指定 sheet
with pd.ExcelWriter(path, engine="openpyxl", mode="a", if_sheet_exists="replace") as writer:
for i, df in enumerate(df_list):
sheet_name = f"JAron_Part{i+1}"
df.to_excel(writer, sheet_name=sheet_name, index=False)? 总结
- ❌ 错误做法：默认 xlsxwriter + mode='a' → 报错；
- ✅ 正确做法：显式指定 engine='openpyxl' + mode='a' + 合理 sheet_name；
- ?️ 最佳实践：集中写入（非并发）、命名唯一、避免 startrow 手动偏移（除非需拼接式布局）；
- ? 补充：若需写入超大数据量，建议启用 if_sheet_exists='overlay' 并配合 startrow 精确定位，但务必确保无重叠区域。
通过以上方法，即可稳健、清晰地将多个 DataFrame 输出至同一 Excel 文件的多个工作表，彻底解决覆盖困扰。
