别再手动改 200 页幻灯片了,40 行代码搞定
上次产品同事找我帮忙:把 50 个客户的 PPT 模板逐个换 logo、改标题、更新数据。
她之前的做法?一个一个打开,手动替换,改完一个大概 5 分钟。
50 个。250 分钟。四个多小时的纯体力活。
我打开编辑器,写了不到 40 行代码,两分钟跑完。她问我是不是写了个宏。
不是。是 Python。
今天就把 python-pptx 这套方法讲透,看完你也能做到。
为什么选 python-pptx?
Python 操作 PPT 的库不多,python-pptx 是唯一靠谱的选择。
- •
python-pptx:读写 .pptx 文件,支持幻灯片、形状、文本、表格、图片,社区活跃 - •
comtypes / win32com:只能在 Windows 上跑,还必须装 PowerPoint,跨平台别想了 - •
Aspose.Slides:功能强但收费,免费版有水印
python-pptx 读写都行,不依赖 Office,Linux/Mac/Windows 通吃。90% 的自动化场景够用了。
安装一行:
pip install python-pptx
先搞懂 PPT 的"术语"
代码里的概念和 PPT 里的东西不是一一对应的,先花 1 分钟对齐:
| | |
|---|
Presentation | | |
Slide | | |
Slide Layout | | |
Shape | | |
TextFrame | | |
Paragraph | | |
重点理解 Shape:PPT 里你能看到的几乎所有东西——文本框、图片、表格、图表、图形——在代码里都是 Shape 对象。这是后面所有操作的基础。
读写基础:5 分钟上手
读取已有的 PPT
拿到一个 PPT 文件,先看看里面有什么:
from pptx import Presentationprs = Presentation('demo.pptx')for i, slide in enumerate(prs.slides): print(f'--- 第 {i+1} 页 ---') for shape in slide.shapes: if shape.has_text_frame: for para in shape.text_frame.paragraphs: print(para.text)
跑一下就能看到每页的文字内容。排查问题、批量提取信息,靠这段代码起步。
从零创建一个 PPT
from pptx import Presentationfrom pptx.util import Inches, Ptprs = Presentation() # 新建,自带一个空白版式# 加一页标题页slide = prs.slides.add_slide(prs.slide_layouts[0]) # 0 = 标题版式slide.shapes.title.text = '季度销售报告'slide.placeholders[1].text = '市场部 · 2025年Q2'prs.save('report.pptx')
slide_layouts[0] 是标题版式,[1] 通常是有标题+内容的版式。先用数字试,不行就打印prs.slide_layouts看看有哪些。
核心操作:文本、图片、表格
添加文本框
PPT 最常见的操作就是加文本框,python-pptx 用坐标和尺寸来定位:
from pptx.util import Inches, Ptfrom pptx.dml.color import RGBColorslide = prs.slides.add_slide(prs.slide_layouts[6]) # 6 = 空白版式# left 和 top 是左上角坐标,width 和 height 是宽高txBox = slide.shapes.add_textbox(Inches(2), Inches(1), Inches(5), Inches(1.5))tf = txBox.text_frametf.text = '这段文字是用 Python 写上去的'# 改样式p = tf.paragraphs[0]p.font.size = Pt(24)p.font.bold = Truep.font.color.rgb = RGBColor(0xFF, 0x66, 0x00) # 橙色
踩坑提醒:坐标单位是"英寸"(Inches),不是像素。一页标准 16:9 的 PPT 大约是 13.33 × 7.5 英寸。写代码的时候最好先在 PPT 里手动调好位置,再把数值写死到代码里。
插入图片
from pptx.util import Inchesslide = prs.slides.add_slide(prs.slide_layouts[6])slide.shapes.add_picture('logo.png', Inches(1), Inches(1), width=Inches(2))
第四个参数可以只传 width 或 height,另一个会自动按比例缩放。别同时传两个,除非你想变形。
操作表格
PPT 里的表格也是 Shape,用行列数创建,然后逐格填数据:
slide = prs.slides.add_slide(prs.slide_layouts[6])rows, cols = 4, 3table_shape = slide.shapes.add_table(rows, cols, Inches(1), Inches(2), Inches(8), Inches(3))table = table_shape.table# 填表头headers = ['产品', 'Q1 销售额', 'Q2 销售额']for i, h in enumerate(headers): table.cell(0, i).text = h# 填数据data = [ ['产品A', '125,000', '168,000'], ['产品B', '89,000', '102,000'], ['产品C', '210,000', '245,000'],]for r, row_data in enumerate(data): for c, val in enumerate(row_data): table.cell(r + 1, c).text = val
批量操作:模板替换才是生产力
这是这篇文章最值钱的部分。 现实中 90% 的 PPT 自动化需求都是"按模板批量生成"。
场景一:替换模板中的占位文本
你有一个标准模板,里面用 {{company}}、{{date}} 之类的占位符,需要批量替换成真实数据:
from pptx import Presentationdef fill_template(template_path, output_path, replacements): """传入模板路径和替换字典,生成新 PPT""" prs = Presentation(template_path) for slide in prs.slides: for shape in slide.shapes: if not shape.has_text_frame: continue for para in shape.text_frame.paragraphs: for run in para.runs: for key, value in replacements.items(): if key in run.text: run.text = run.text.replace(key, value) prs.save(output_path)# 用法fill_template('template.pptx', '客户A.pptx', { '{{company}}': '某科技有限公司', '{{date}}': '2025年6月15日', '{{amount}}': '¥328,000',})
关键细节:替换要放在 run.text 上而不是 paragraph.text 上。直接改 paragraph.text 会丢失所有格式(加粗、颜色、字体全没了),改 run.text 只替换文字,格式原封不动。这个坑我踩了不下三次。
场景二:批量生成多个 PPT
把场景一封装一下,配合数据源批量跑:
from pptx import Presentationimport csvdef batch_generate(template_path, data_csv, output_dir): with open(data_csv, 'r', encoding='utf-8') as f: reader = csv.DictReader(f) for i, row in enumerate(reader): prs = Presentation(template_path) for slide in prs.slides: for shape in slide.shapes: if shape.has_text_frame: for para in shape.text_frame.paragraphs: for run in para.runs: for key, value in row.items(): placeholder = f'{{{{{key}}}}}' if placeholder in run.text: run.text = run.text.replace(placeholder, value) output_path = f'{output_dir}/{row.get("company", f"output_{i+1}")}.pptx' prs.save(output_path) print(f'已生成: {output_path}')batch_generate('template.pptx', '客户列表.csv', './输出/')
CSV 文件长这样:
company,date,amount某科技有限公司,2025-06-15,328000某贸易有限公司,2025-06-16,156000某制造有限公司,2025-06-17,492000
50 个客户 PPT,两分钟跑完。 这就是开头说的那件事。
进阶:改样式、删页面、移动元素
修改已有文本的样式
for slide in prs.slides: for shape in slide.shapes: if shape.has_text_frame: for para in shape.text_frame.paragraphs: for run in para.runs: run.font.size = Pt(14) run.font.name = '微软雅黑' run.font.color.rgb = RGBColor(0x33, 0x33, 0x33)
注意:font.name 设置的是英文字体,中文要额外设 font.name 为中文字体名。如果改完发现中文没变,多半是字体名写错了——用 PPT 里实际显示的字体名称。
删除某一页
python-pptx 没有直接的 slide.delete() 方法,但可以通过操作内部 XML 来实现:
import copydef delete_slide(prs, index): """删除指定索引的幻灯片(从 0 开始)""" rId = prs.slides._sldIdLst[index].get('{http://schemas.openxmlformats.org/officeDocument/2006/relationships}id') prs.part.drop_rel(rId) del prs.slides._sldIdLst[index]delete_slide(prs, 2) # 删除第 3 页
常见坑和解决方案
| | |
|---|
| | |
| font.name | |
| | |
| Presentation() | 用 Presentation('模板.pptx') |
| | |
完整实战脚本
把上面的内容揉在一起,一个能直接跑的完整脚本:
from pptx import Presentationfrom pptx.util import Inches, Ptfrom pptx.dml.color import RGBColorfrom pathlib import Pathdef generate_monthly_report(template_path, company, date, data_rows, output_path): """基于模板生成月度报告 PPT""" prs = Presentation(template_path) # 替换占位符 replacements = { '{{company}}': company, '{{date}}': date, } for slide in prs.slides: for shape in slide.shapes: # 替换文本 if shape.has_text_frame: for para in shape.text_frame.paragraphs: for run in para.runs: for key, value in replacements.items(): if key in run.text: run.text = run.text.replace(key, value) # 填充表格数据 if shape.has_table: table = shape.table for r, row_data in enumerate(data_rows): if r + 1 < len(table.rows): for c, val in enumerate(row_data): if c < len(table.columns): table.cell(r + 1, c).text = str(val) prs.save(output_path) print(f'✅ 已生成: {output_path}')# 用法generate_monthly_report( template_path='月报模板.pptx', company='某科技有限公司', date='2025年6月', data_rows=[ ['产品A', '125,000', '168,000', '+34%'], ['产品B', '89,000', '102,000', '+15%'], ], output_path='某科技-2025年6月月报.pptx')
写在最后
Python 操作 PPT 这件事,本质上就是把重复的手工活交给代码。
python-pptx 覆盖了绝大多数日常需求:读写、替换、加文字图片表格。真正复杂的动画效果和高级排版,老实说还是得在 PPT 里手动调。
但那些"改个标题换个 logo 做 50 份"的活,交给 Python 是正道。
留个问题:如果你的模板里有图表(Chart),需要动态改数据,该怎么办?python-pptx 支持,但坑不少——评论区聊。