ReportLab是最稳的PDF报表生成方案,纯Python无依赖,适合结构化报表;weasyprint适合HTML模板场景但受字体和CSS兼容性限制;pdfkit和matplotlib因外部依赖或功能局限不推荐。

用 ReportLab 是最稳的选择,尤其适合结构化报表;weasyprint 适合已有 HTML 模板的场景,但依赖系统字体和 CSS 兼容性。
为什么不用 pdfkit 或 matplotlib 直接画 PDF?
前者本质是调用 wkhtmltopdf,需额外安装二进制、跨环境易出错(比如 Linux 服务器缺字体或 X11);后者适合单图/简单图表,生成多页带表格+样式+页眉页脚的报表非常吃力,代码冗长且难维护。而 ReportLab 纯 Python 实现,无外部依赖,SimpleDocTemplate + Table + Paragraph 组合就能覆盖 90% 的报表需求。
ReportLab 动态生成带样式的 PDF 报表
核心是把数据转成 Flowable 对象列表,再交给 SimpleDocTemplate.build() 渲染。注意三点:
-
PageBreak()必须显式插入才能分页,不会自动换页 - 中文需注册字体,否则显示为方块:
pdfmetrics.registerFont(TTFont('SimSun', 'simsum.ttc'))(Windows 下路径可用os.path.join(os.environ['WINDIR'], 'Fonts', 'simsum.ttc')) -
Table的style参数必须用TableStyle实例,不能传字典;常用命令如('BACKGROUND', (0,0), (-1,0), colors.grey)表示首行背景色
weasyprint
从 HTML 模板生成 PDF(适合前端协作场景)
当报表结构复杂、含 CSS 样式或需要复用现有 HTML 页面时更合适,但要注意:
- HTML 中的相对路径(如
)在 PDF 中不生效,必须转为绝对路径或 base64 内联
- CSS 的
@page规则控制页边距、页眉页脚,但部分属性(如margin-top)在页眉中行为异常,建议用position: running()配合::before替代 - 字体必须用
@font-face显式加载,系统字体名不可靠(例如 macOS 的"PingFang SC"在 Linux 上不存在)
Table
单元格内容超长时的截断处理——这些细节不报错,但输出结果会静默异常。动手前先用最小数据集跑通一页,再逐步加样式和分页逻辑。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











