Python纯内存实现DataFrame转Excel 无需本地文件读写

原有方案问题说明 #

• 方案1思路错误：df.to_json()输出的是JSON格式纯文本，和Excel二进制格式结构完全不同，无法直接转换为合法Excel文件。
• 方案2思路正确，打印乱码是正常现象：Excel（.xlsx/.xls）是二进制压缩格式，并非纯文本文件，直接将二进制字节打印到文本终端必然显示乱码，不代表文件损坏。

前置依赖 #

需要先安装Excel写入引擎依赖，执行命令：
pip install pandas openpyxl
不要使用已停止维护的xlwt引擎，该引擎仅支持老旧的.xls格式，兼容性差。

完整实现代码 #

1. 内存生成合法Excel二进制流 #

import io
import pandas as pd
import base64

# 假设df为你已处理完成的目标DataFrame
# 初始化内存字节流
memory_buffer = io.BytesIO()

# 通过ExcelWriter将DataFrame以xlsx格式写入内存流，上下文管理器会自动完成文件格式收尾
with pd.ExcelWriter(memory_buffer, engine='openpyxl') as writer:
    # 可自定义参数：是否保留索引、工作表名称等
    df.to_excel(writer, index=False, sheet_name='导出数据')

# 将流指针重置到起始位置，读取完整Excel二进制内容
memory_buffer.seek(0)
excel_file_bytes = memory_buffer.getvalue()

# 验证文件合法性（可选）：xlsx为zip压缩格式，合法文件前2字节为PK标识
assert excel_file_bytes[:2] == b'PK', "Excel文件格式异常"

2. 对接SendGrid作为附件发送 #

SendGrid附件要求传入base64编码的文件内容，直接基于上述内存中的二进制内容构造即可，全程无本地文件操作：

from sendgrid import SendGridAPIClient
from sendgrid.helpers.mail import Mail, Attachment, FileContent, FileName, FileType, Disposition

# 二进制内容转base64编码
encoded_excel = base64.b64encode(excel_file_bytes).decode()

# 构造附件对象
excel_attachment = Attachment()
excel_attachment.file_content = FileContent(encoded_excel)
excel_attachment.file_name = FileName("数据导出结果.xlsx") # 收件人看到的附件文件名
excel_attachment.file_type = FileType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet") # xlsx格式对应MIME类型
excel_attachment.disposition = Disposition("attachment")

# 正常构造邮件对象，将附件加入邮件即可
# mail = Mail(from_email='xxx@xxx.com', to_emails='xxx@xxx.com', subject='数据导出', plain_text_content='请查收附件')
# mail.attachment = excel_attachment
# 后续调用SendGridAPIClient发送即可

注意事项 #

• 不要直接打印memory_buffer.read()的结果：二进制内容打印到文本终端必然显示乱码，属于正常表现，通过上述文件头校验即可确认格式合法。
• 必须使用ExcelWriter上下文管理器写入：部分pandas版本直接调用df.to_excel(memory_buffer)不会写入Excel文件尾标识，会导致生成的文件损坏无法打开。
• 全程不要传入任何本地文件路径参数，所有读写操作均在内存BytesIO对象中完成，符合无本地读写权限的运行环境要求。

内容的提问来源于stack exchange，提问作者MatCode