excelwriter用完不close()会导致文件损坏，因缓冲区未刷新、资源未释放，造成写入不完整；必须用with语句自动关闭，或确保close()在所有to_excel()之后且不重复调用。
ExcelWriter 用完不 close() 会导致文件损坏
生成 Excel 报表最常踩的坑是忘记调用 close() 或没用上下文管理器，结果文件看似生成成功，但双击打不开，或打开后提示“文件已损坏”。这是因为 pd.ExcelWriter 底层依赖 openpyxl 或 xlsxwriter，缓冲区未刷新、资源未释放就会写入不完整。
- 必须用
with pd.ExcelWriter(...)语法，它会自动调用close() - 手动调用时，
writer.close()要放在所有to_excel()之后，且不能重复调用 - 若在 Flask/FastAPI 中返回文件流，确保
BytesIO已 seek(0)，否则前端收到空文件
多 Sheet 写入时 engine 选错会丢样式或公式
openpyxl 和 xlsxwriter 对多 Sheet 支持差异大：前者支持读写、保留已有样式和公式；后者只支持写入、不兼容已有 Excel 结构。Web 后台动态生成报表时，若需复用模板（含图表、条件格式），必须用 openpyxl。
- 显式指定
engine='openpyxl'，尤其在安装了多个引擎时，Pandas 可能默认选错 -
xlsxwriter不支持追加写入已有 Sheet，openpyxl支持但需先用load_workbook加载再传给ExcelWriter - 写入大量数据时，
xlsxwriter内存更省，但 Web 场景通常更看重兼容性而非极致性能
datetime 和 NaN 处理不当会让 Excel 显示为 1900/1/0 或 #VALUE!
Pandas 的 datetime64[ns] 和 NaT 直接写入 Excel 容易出问题：openpyxl 默认把 NaT 当作 0，显示成 Excel 的纪元日期（1900/1/0）；而 NaN 在数值列中可能变成 #VALUE!。
- 写入前统一处理：
df = df.fillna('')或df = df.replace({pd.NaT: None, np.nan: None}) - 对时间列，用
dt.strftime('%Y-%m-%d %H:%M:%S')转字符串（适合只读报表），或保留 datetime 类型但确保openpyxl版本 ≥3.1（修复了 NaT 写入问题） - 避免在 ExcelWriter 中设置
date_format参数——它只影响新写入的 datetime，对 NaT 无效
Flask 返回 Excel 文件时 Content-Disposition 缺少 filename*
中文文件名在 Chrome/Firefox 下乱码，是因为只设了 filename="报表.xlsx"，没提供 UTF-8 编码的 filename*=UTF-8''%E6%8A%A5%E8%A1%A8.xlsx 形式。
- 用
urllib.parse.quote编码文件名：filename = urllib.parse.quote("销售报表.xlsx") - 响应头必须同时包含两个字段：
Content-Disposition: attachment; filename="sales.xlsx"; filename*=UTF-8''%E9%94%80%E5%94%AE%E6%8A%A5%E8%A1%A8.xlsx - 别忘了设
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
