用 to_excel() 写单个 DataFrame 最简单；多 Sheet 必须用 with ExcelWriter() 管理；引擎选 xlsxwriter（新建快）或 openpyxl（可修改模板）；注意路径、sheet_name 限制及中文/日期显示问题。
直接用 to_excel() 就够了，除非你要写多个 Sheet
单个 DataFrame 写入 Excel，to_excel() 是最简单、最不容易出错的方式。它背后自动调用 openpyxl（默认）或 xlsxwriter 引擎，封装了所有底层细节。你不用管文件打开/关闭、Sheet 名冲突、样式兼容性这些事。
常见错误现象：FileNotFoundError 或写入后打不开 Excel —— 多半是路径里用了中文、空格或相对路径没对上；还有人误传 engine='xlsxwriter' 后又想用 openpyxl 特性（比如合并单元格），结果报错。
- 路径必须是字符串，且推荐用
os.path.join()或pathlib.Path拼接，避免反斜杠问题 -
index=False基本都要加，否则多一列行号，业务方常吐槽 - 如果数据含
datetime64，注意openpyxl会保留时区信息，而xlsxwriter会丢掉——导出报表前务必检查时间字段是否偏移
写多个 Sheet 必须用 ExcelWriter，但别手动 close()
ExcelWriter 不是函数，是上下文管理器类，核心作用是复用同一个 Excel 文件句柄，避免反复打开关闭导致性能下降或锁文件。手动调用 .close() 容易漏写、或在异常后没执行，导致文件损坏或被占用。
使用场景：导出日报的「汇总表」「明细表」「趋势图数据」三个 Sheet；或者把不同分组的 DataFrame 分别写进同个 Excel 的不同页签。
- 必须用
with ExcelWriter(...)语法，哪怕只写一个 Sheet 也建议这么写，安全又省心 -
sheet_name长度不能超过 31 字符，且不能含\ / ? * [ ]—— 超长或非法字符会静默截断或报ValueError: Invalid character in sheet name - 如果写入的 Sheet 名重复，后一次会覆盖前一次，不会合并；想追加得先读原文件再写新 Sheet，
ExcelWriter本身不支持“追加模式”
with pd.ExcelWriter('report.xlsx', engine='openpyxl') as writer:
df_summary.to_excel(writer, sheet_name='汇总', index=False)
df_detail.to_excel(writer, sheet_name='明细', index=False)
openpyxl 和 xlsxwriter 引擎选哪个？看你要不要改已有内容
openpyxl 支持读+写+修改已有 Excel（比如往模板里填数据），xlsxwriter 只能新建文件。但 xlsxwriter 写大文件更快、内存占用更低，且对公式、图表支持更稳定。
性能影响：10 万行以上数据写入，xlsxwriter 通常快 20%~40%；但如果你要读取一个带格式的模板 Excel，再往里面写数据，xlsxwriter 直接报错 UnsupportedOperation: Cannot write to an already open file。
- 日常导出新报表 → 优先
xlsxwriter（需pip install xlsxwriter） - 填充固定格式模板（如财务月报模板）→ 必须
openpyxl（且要用if_sheet_exists='replace'控制冲突行为） - 别混用：
to_excel(engine='xlsxwriter')写的文件，后续不能用openpyxl.load_workbook()修改样式，会提示“文件已损坏”
中文乱码、数字变科学计数、日期变数字？不是 Pandas 的锅
这些现象几乎全是 Excel 自身的显示逻辑导致的，Pandas 已经把正确类型写进去了。比如 1234567890123456789 被显示成 1.23457E+18，是因为 Excel 对整数精度限制为 15 位，和 Pandas 无关。
容易被忽略的地方：你双击单元格再回车，数字就恢复原样；但批量导出时没人去点。真正需要干预的是日期和中文列宽。
- 日期列写入后显示为数字（如
44562）→ 是 Excel 底层序列号，设置单元格格式为“日期”即可，Pandas 无法强制设格式 - 中文列宽太窄 →
openpyxl可用worksheet.column_dimensions['A'].width = 20手动调，但要在ExcelWriter关闭前操作；xlsxwriter则用set_column() - 导出后中文显示为方块 → 检查系统是否缺中文字体，或 Excel 设置里禁用了“启用字体替换”，不是编码问题
事情说清了就结束。多 Sheet 场景下，ExcelWriter 的上下文管理、引擎选择、Sheet 名校验这三步漏掉任意一个，都可能让导出脚本在线上跑着跑着就卡住或生成坏文件。
