Python自动生成数据报告需三步联动：用pandas+openpyxl生成带样式的Excel（支持合并单元格、图表、自动列宽），用Jinja2+WeasyPrint/pdfkit将HTML模板转PDF（注意中文字体与编码），最后封装双格式导出函数并统一命名、校验文件。
用Python自动生成数据报告并导出为PDF和Excel，核心在于“内容生成 + 格式控制 + 文件导出”三步联动。不依赖复杂框架，用成熟库组合就能稳定产出专业报告。
用pandas + openpyxl生成结构化Excel报告
pandas负责数据处理与表格组织，openpyxl接管样式、合并单元格、图表等增强功能。直接用df.to_excel()只能输出纯数据，加了openpyxl才能做标题居中、列宽调整、条件格式等。
- 先用
pandas.ExcelWriter指定引擎为openpyxl，确保可写样式 - 写入数据后，通过
writer.sheets['Sheet1']获取工作表对象，设置cell.font、cell.alignment、ws.merge_cells() - 如需自动列宽，遍历每列，按最长字符串长度动态设置
column_dimensions[col].width - 图表支持：用
openpyxl.chart添加柱状图/折线图，绑定数据范围即可
用Jinja2 + WeasyPrint或pdfkit生成PDF报告
PDF排版自由度高但原生难控，推荐“HTML模板 → 渲染 → 转PDF”路径。Jinja2写动态HTML（插入表格、图表、标题），WeasyPrint（纯Python）或pdfkit（调用wkhtmltopdf）执行转换。
- Jinja2模板里用
{{ df.to_html(classes='table', index=False, header=True) }}快速嵌入表格，再配CSS定义边框、字体、响应式宽度 - WeasyPrint对中文支持好，只需安装
weasyprint和系统级字体（如Noto Sans CJK），在CSS中指定font-family: "Noto Sans CJK SC" - pdfkit更轻量，但需额外安装wkhtmltopdf二进制，适合CI/CD环境；注意路径配置和中文编码（HTML头加
<meta charset="utf-8">）
一键整合：PDF+Excel双输出脚本示例
实际业务中常需同一份分析结果同步输出两种格式。建议封装成函数，输入DataFrame和报告参数，内部并行生成。
立即学习“Python免费学习笔记（深入）”；
- Excel部分：用openpyxl写入多sheet（如“概览”“明细”“图表”），每个sheet加时间戳水印或公司LOGO图片（
ws.add_image()） - PDF部分：将关键指标、统计图表、表格摘要渲染进HTML，再转PDF；可把Excel中的图表截图嵌入HTML提升可读性
- 文件命名统一规则，如
f"report_{datetime.now().strftime('%Y%m%d_%H%M')}_{version}.xlsx"，方便归档与版本管理
避坑提醒：中文字体、权限与兼容性
中文字体缺失会导致PDF乱码、Excel显示方块；Linux服务器无图形界面时图表生成易失败；旧版Excel打开xlsx报错——这些不是代码问题，而是环境细节。
- Windows下WeasyPrint默认可用微软雅黑，Linux需手动注册字体：
from weasyprint import FontConfiguration; font_config = FontConfiguration(); font_config.add_font(...) - 服务器端生成图表（如matplotlib），设
plt.switch_backend('Agg')避免GUI依赖 - Excel导出后建议用
openpyxl.load_workbook()简单打开验证，捕获InvalidFileException提前拦截损坏文件
