pdfpages保存多图pdf需显式调用close()、每张图用plt.figure()或fig对象控制；避免复用figure导致重叠；设figsize防挤压；用fig.text加页码；中文需设字体；大量图时及时plt.close()防oom。
PdfPages类的基本用法和常见报错
直接用 PdfPages 保存多图 PDF 是最稳妥的方式，但新手常卡在“文件没关闭导致内容为空”或“图表不显示”上。核心就两点：必须显式调用 close()，且每张图要先 plt.figure() 或用 fig 对象明确控制。
典型错误是循环里反复用 plt.plot() 却没清空或新建 figure，结果所有数据叠在一张图上，最后 PDF 只有一页、内容混乱。
- 每次绘图前加
plt.figure(figsize=(8, 6))，避免复用默认 figure - 画完立刻用
pdf.savefig(fig)（推荐传 figure 对象）或pdf.savefig()（捕获当前 active figure） - 循环结束后务必调用
pdf.close()，否则 PDF 文件大小为 0 字节 - 不要在
with PdfPages(...)外部再调用plt.show()，容易触发 backend 冲突
如何避免图表重叠和尺寸错乱
PDF 页面默认是 A4 尺寸（约 8.27×11.69 英寸），而 Matplotlib 默认 figure 是 6.4×4.8 英寸。如果没设 figsize，多图排版会挤压、字体变小、坐标轴截断。
更隐蔽的问题是：用 plt.subplot() 或 plt.subplots() 创建的图，若未指定 fig 变量，pdf.savefig() 可能抓不到正确对象。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 统一用面向对象方式：创建
fig, ax = plt.subplots(figsize=(8, 5))，后续操作全走ax.plot() - 保存时传
pdf.savefig(fig)，不依赖当前 active 状态 - 如需统一字体/边距，可在循环外调用
plt.rcParams.update({...})，但注意它会影响后续所有图 - 导出前加
plt.tight_layout()，防止标题或标签被裁切
带标题、页码和自定义元数据的 PDF
PdfPages 支持写入 PDF 元信息（作者、标题等），也能在每页加文字水印或页码——但不能用 plt.text() 直接写在 figure 上，因为那是绘图内容；页码得靠 pdf.infodict() 和手动插入文本 artist。
- 初始化后立即设置元数据：
pdf.infodict()['Title'] = 'My Report'，支持'Author'、'Subject' - 页码建议用
fig.text(0.95, 0.02, f'p.{i+1}', ha='right', fontsize=9)插入右下角（i是循环索引） - 避免在
plt.suptitle()里写动态内容（如日期），它可能和tight_layout()冲突；改用fig.suptitle(...)并手动调整fig.subplots_adjust(top=0.92) - 中文标题需提前设置字体：
plt.rcParams['font.sans-serif'] = ['SimHei', 'DejaVu Sans']，否则显示方块
性能与大图数量下的注意事项
导出上百张图时，内存会持续增长——因为 PdfPages 在内部缓存所有 figure 的 rasterized 数据，直到 close() 才写入磁盘。卡顿、OOM 常因此发生。
- 每画完 10–20 张图，可手动调用
plt.close(fig)或plt.close('all')释放 figure 对象 - 避免在循环中反复
import matplotlib.pyplot as plt或修改全局 rcParams - 若图表结构一致（如时间序列批量绘图），优先用
ax.clear()复用同一 figure+ax，比新建更快 - 极大量图表（>500）建议分批次写入多个 PDF，或改用
cairocffi+matplotlib.backends.backend_cairo降低内存压力
最容易被忽略的是：PDF 导出不触发自动重绘（draw()），所以如果图中用了延迟渲染（如某些 basemap 或 cartopy 图层），需在 savefig() 前加 fig.canvas.draw()，否则页面空白。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
