Python怎么导出Excel_API生成Excel流并返回供浏览器下载
必须用 BytesIO 拦截 to_excel 输出流并调用 seek(0)，Content-Type 需设为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，filename 要用双引号或 UTF-8 编码，空值需 fillna 处理，大文件应分页或改用 CSV。
用 pandas.DataFrame.to_excel 生成内存 Excel 流，别写文件
直接调用 to_excel 写磁盘再读取是典型反模式——多一次 I/O，还可能因并发或权限出错。必须用 BytesIO 拦截输出流。
-
to_excel的buffer参数接受任意类文件对象，传BytesIO()即可 - 写完后记得调用
.seek(0)，否则后续读取会从末尾开始，返回空内容 - 别用
StringIO，Excel 是二进制格式，StringIO会报TypeError: expected bytes, got str
from io import BytesIO import pandas as pdoutput = BytesIO() df.to_excel(output, index=False) output.seek(0) # 关键一步
Flask/FastAPI 返回 Excel 流时的 Content-Type 和 Content-Disposition
浏览器靠响应头判断是否触发下载。错一个字段，Excel 就变成乱码页面或被强行打开。
-
Content-Type必须是application/vnd.openxmlformats-officedocument.spreadsheetml.sheet（xlsx）或application/vnd.ms-excel（xls），不能用application/octet-stream -
Content-Disposition中的filename值需用双引号包裹，且建议只含 ASCII 字符；中文名要加filename*=UTF-8''xxx.xlsx编码，否则 Safari/Edge 可能截断 - FastAPI 用户注意：
Response构造时传media_type，别依赖自动推断
# Flask 示例
return send_file(
output,
mimetype="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
as_attachment=True,
download_name="data.xlsx" # Flask 2.1+ 用 download_name，旧版用 attachment_filename
)
用 openpyxl 手动构造复杂 Excel 时如何避免 ValueError: Can't convert 'None' to Excel
当 DataFrame 含 None、NaT、NaN 或自定义空值对象，openpyxl 直接写单元格会崩。pandas 默认已处理，但手动操作时得自己兜底。
- 先用
df.fillna("")或df.replace({pd.NaT: "", pd.NA: "", None: ""})清洗数据 - 遍历写入前检查值类型：
if pd.isna(cell_value): cell.value = "" - 日期列若为
NaT，不要转datetime再写，openpyxl不认NaT，也不建议写字符串“N/A”，会丢失 Excel 日期格式识别能力
大文件导出卡顿或内存爆掉？别让整个 DataFrame 呆在内存里
几百万行导 Excel，BytesIO + pandas.to_excel 会吃光内存，且用户等不到响应。得换策略。
Stable Diffusion
目前最强的开源AI绘画工具
下载
立即学习“Python免费学习笔记（深入）”；
- 优先考虑分页导出：前端传
page=1&size=50000，后端只查并导当前批次 - 真要单文件超大，改用
xlsxwriter的 streaming 模式（它不支持读，只写），配合yield分块写入，但需放弃 pandas 样式和公式 - 更现实的解法：导 CSV。用
df.to_csv(output, index=False)，内存占用低两个数量级，浏览器一样能下载打开
生成 Excel 流这事本身不难，难的是边界情况——空数据、时区混杂的 datetime、带合并单元格的模板、还有用户偷偷在 filename 里塞了斜杠或控制字符。这些地方一漏，线上就收 500 错误。