reportlab 不能直接绘制复杂图表，需先用 matplotlib 等生成 png 图片，再通过 image 类插入 pdf；须注意字体设置、尺寸匹配、内存缓冲区 seek(0) 及每次绘图后 plt.close('all')。
ReportLab 能直接画图表吗？
不能。ReportLab 本身不提供 matplotlib 或 seaborn 那样的绘图能力，它的 drawString、drawLine 等原语只适合画简单图形。想在 PDF 里嵌入柱状图、折线图，得先用其他库生成图片，再把图片插入 ReportLab 文档。
常见做法是：用 matplotlib 生成 PNG/SVG → 保存到临时文件或内存缓冲区 → 用 ReportLab 的 Image 类加载并插入 PDF。
- 别试图用
reportlab.graphics模块画复杂图表——它仅支持极简的LinePlot、BarChart，样式僵硬、坐标轴难调，实际项目中基本弃用 - 生成图表时记得设
plt.figure(dpi=150, figsize=(6, 4))，避免 PDF 里图片模糊 - 用
io.BytesIO()把图写进内存而非磁盘，减少临时文件清理负担
如何把 matplotlib 图塞进 ReportLab 的 Flowable 流中？
ReportLab 的 SimpleDocTemplate 依赖 Flowable 对象（如 Paragraph、Spacer）排版。图片必须包装成 Image 实例，且尺寸需提前算好，否则容易撑出页边或压缩变形。
关键点：传给 Image 构造函数的路径/字节流，和后续设置的 width/height 必须匹配比例，否则失真。
- 从
BytesIO创建Image时，务必调用seek(0)，否则 ReportLab 读不到内容 - 推荐用
img.drawWidth和img.drawHeight获取原始尺寸，再按页面宽度缩放：img.drawWidth = width * 0.9 - 避免直接传
plt.savefig(..., bbox_inches='tight')—— 它可能裁掉图例或坐标轴标签；改用plt.tight_layout()+ 显式pad_inches
中文标题和坐标轴文字显示为方块？
这是 ReportLab 和 matplotlib 双重字体缺失问题。ReportLab 默认不带中文字体，matplotlib 也默认用无衬线英文字体。
解决路径分两段：一是让 matplotlib 输出带中文的图（需指定字体），二是确保 ReportLab 插入的图片本身已渲染正确——不是靠 ReportLab 渲染文字。
- matplotlib 中提前设置：
plt.rcParams['font.sans-serif'] = ['SimHei', 'Arial Unicode MS', 'DejaVu Sans']，并加plt.rcParams['axes.unicode_minus'] = False - 不用管 ReportLab 是否注册中文字体——因为图已是位图，文字早已固化在像素里
- 如果用 SVG 导出再转 PDF，反而更容易丢字体，坚持用 PNG
生成多页报告时图表位置错乱或重复？
典型原因是把图表生成逻辑写在循环外，或多次复用同一个 plt.figure() 对象。matplotlib 的状态机模式会让后一次绘图覆盖前一次，导致所有页面插入同一张图。
每张图必须独立创建、绘制、保存、清空。
- 每次循环内调用
plt.figure()，绘图结束后立刻plt.close('all')，释放内存和句柄 - 别用全局
fig变量；也不要用plt.gca()隐式获取 axes——显式写fig, ax = plt.subplots() - ReportLab 的
PageBreak()放在图表 Flowable 之后，而不是之前；否则最后一页可能空白
ReportLab 插图这件事，核心就一条：图是“成品快照”，不是“可编辑对象”。所有样式、字体、尺寸，必须在 matplotlib 阶段定死，ReportLab 只负责把它按尺寸摆正。漏掉 plt.close() 或忘了 seek(0)，是线上脚本静默失败最常踩的两个坑。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
