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)表示首行背景色
<pre class="brush:php;toolbar:false;">from reportlab.platypus import SimpleDocTemplate, Table, TableStyle, Paragraph, Spacer, PageBreak
from reportlab.lib.styles import getSampleStyleSheet
from reportlab.lib import colors
<p>styles = getSampleStyleSheet()
styles['Normal'].fontName = 'SimSun' # 中文字体
doc = SimpleDocTemplate("report.pdf")
elements = [
Paragraph("销售日报", styles['Title']),
Spacer(1, 12),
Table(data=[['日期', '销售额', '订单数'], ['2024-04-01', '¥12,500', '87']],
style=TableStyle([('BACKGROUND', (0,0), (-1,0), colors.grey),
('TEXTCOLOR', (0,0), (-1,0), colors.whitesmoke)]))
]
doc.build(elements)</p>weasyprint
从 HTML 模板生成 PDF（适合前端协作场景）当报表结构复杂、含 CSS 样式或需要复用现有 HTML 页面时更合适，但要注意：
- HTML 中的相对路径（如
<img src="logo.png">）在 PDF 中不生效，必须转为绝对路径或 base64 内联 - CSS 的
@page规则控制页边距、页眉页脚，但部分属性（如margin-top）在页眉中行为异常，建议用position: running()配合::before替代 - 字体必须用
@font-face显式加载，系统字体名不可靠（例如 macOS 的"PingFang SC"在 Linux 上不存在）
<pre class="brush:php;toolbar:false;">from weasyprint import HTML
<p>html = """
</p><style>
@font-face { src: url('/path/to/simsum.ttf'); font-family: 'SimSun'; }
body { font-family: 'SimSun'; }
</style><h1>报表</h1><p>数据：{{ data }}</p>
"""<h1>注意：实际使用需用 jinja2 渲染 {{ data }}，且确保 /path/to/simsum.ttf 可被访问</h1><p>HTML(string=html).write_pdf("report.pdf")</p>真正容易卡住的不是语法，而是字体路径、CSS 分页逻辑、以及 Table
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
