python-pptx适合批量生成结构正确、内容可读的PPT,推荐基于设计好的模板复用母版与占位符,用name定位而非索引,图表转PNG插入,表格用add_table并调行高,关闭auto_size防中文乱码,字体设段落级,确保模板健壮性。

能批量生成 PPT,但别指望用 python-pptx 做出和 PowerPoint 手动编辑一模一样的动画、母版嵌套或 SVG 渲染效果——它生成的是结构正确、内容可读、样式可控的 .pptx 文件,适合报表、周报、培训材料等模板化场景。
用 python-pptx 替换占位符比从头画幻灯片更稳
直接新建每一页并手动添加文本框/图片容易错位、字体不一致、缩进失控。推荐基于一个设计好的源 PPT(template.pptx),复用其母版、主题色、标题/正文占位符布局。
- 源文件里把需要动态填充的地方设为占位符(例如:标题占位符命名为
"title",正文占位符命名为"content"),不要用普通文本框 - 加载时用
Presentation("template.pptx"),再用slide.placeholders[0].text = "新标题"赋值;若占位符有名称,优先用slide.shapes.title.text = ...或slide.placeholders.get("content").text = ... - 如果占位符被删过又重建,索引可能错乱,务必用
placeholder.name或placeholder.placeholder_format.type(如PP_PLACEHOLDER.TITLE)来定位,别硬写[0]、[1]
插入图表和表格要绕开 add_chart() 的坑
python-pptx 的 add_chart() 不支持所有 Excel 图表类型,且无法设置坐标轴格式、数据标签样式等细节。实际批量中更可靠的做法是:先用 matplotlib 或 plotly 生成 PNG,再用 slide.shapes.add_picture() 插入。
- 保存图表时加
bbox_inches="tight", pad_inches=0.1防边缘裁切 - 表格建议用
add_table()而非图片——它支持单元格合并、字体设置;但注意行高默认很小,需遍历cell.text_frame.paragraphs[0].font.size和cell.vertical_anchor调整 - 避免在循环里反复调用
prs.save(),全部写完再存一次,否则 I/O 开销大、易卡死
中文乱码?不是字体问题,是文本框属性没关
即使设置了 font.name = "微软雅黑",仍可能显示方块——根本原因是 PowerPoint 默认启用「将文字调整为适应形状」,会强制压缩字距、破坏中文字体渲染。
立即学习“Python免费学习笔记(深入)”;
- 对每个
text_frame,必须显式关闭:tf.auto_size = None,tf.word_wrap = True,tf.vertical_anchor = MSO_ANCHOR.TOP - 字体设置要落到段落级:
p = tf.paragraphs[0]; p.font.name = "微软雅黑"; p.font.size = Pt(18),仅设tf.paragraphs[0].font不生效 - 如果模板里用了非系统字体(比如思源黑体),导出后在没装该字体的电脑上会 fallback 成宋体,但不会报错——提前确认目标环境字体可用性
批量生成真正的难点不在代码,而在模板的健壮性:占位符命名是否唯一、母版页是否锁定、图片路径是否相对、表格行列数是否和数据严格匹配。跑通一次不难,跑通一百份不同数据才见真章。


















