python-pptx 的layout 布局
一、布局基础概念
在 PowerPoint 中，布局（Layout） 决定了幻灯片的占位符（如标题、内容、图片等）的排列方式。python-pptx 提供了对布局的编程控制。
二、默认布局类型及索引
通过 prs.slide_layouts[index] 访问，以下是常见默认布局（不同模板可能有变化）：
| 索引 | 布局名称 | 包含占位符 | 备注 |
|---|---|---|---|
| 0 | Title Slide | 主标题 + 副标题 | |
| 1 | Title and Content | 标题 + 正文/图片/图表 | |
| 2 | Section Header | 章节标题 + 描述文字 | |
| 3 | Two Content | 标题 + 左右两栏内容 | |
| 5 | Title Only | 仅标题 | |
| 6 | Blank | 空白幻灯片 | |
| 7 | Content with Caption | 标题 + 图片 + 底部说明文字 | |
| 8 | Picture with Caption | 标题 + 大图 + 底部文字 |
三、代码实战：布局操作
1. 查看所有布局
from pptx import Presentationprs = Presentation()
for idx, layout in enumerate(prs.slide_layouts):print(f"Layout {idx}: {layout.name}")for shape in layout.placeholders:print(f" - 占位符类型: {shape.placeholder_format.type}")
2. 添加带标题和内容的幻灯片
slide = prs.slides.add_slide(prs.slide_layouts[1]) # Title and Content
slide.shapes.title.text = "这是标题"
content = slide.placeholders[1] # 内容占位符
content.text = "第一点\n第二点" # 或插入图片/图表
3. 强制修改布局元素
如果布局不包含所需占位符，手动添加：
from pptx.util import Inchesslide = prs.slides.add_slide(prs.slide_layouts[6]) # Blank
# 手动添加标题
title_box = slide.shapes.add_textbox(Inches(1), Inches(0.5), Inches(8), Inches(1))
title_box.text = "自定义标题"
四、布局选择策略
| 场景 | 推荐布局 | 代码示例 |
|---|---|---|
| 封面页 | Layout 0 (Title Slide) | prs.slide_layouts[0] |
| 图文混合页 | Layout 1 (Title and Content) | prs.slide_layouts[1] |
| 纯图片展示 | Layout 8 (Picture with Caption) | prs.slide_layouts[8] |
| 分栏内容 | Layout 3 (Two Content) | prs.slide_layouts[3] |
| 自定义自由排版 | Layout 6 (Blank) | prs.slide_layouts[6] |
五、高级技巧
1. 检查占位符是否存在
slide = prs.slides.add_slide(prs.slide_layouts[1])
if slide.shapes.title:print("当前布局包含标题占位符")
2. 替换占位符为图片
slide = prs.slides.add_slide(prs.slide_layouts[1])
slide.shapes.title.text = "数据报告"
picture = slide.placeholders[1].insert_picture("chart.png")
3. 自定义布局（需修改模板）
- 在 PowerPoint 中设计自定义布局并保存为
.pptx文件 - 代码加载自定义模板：
prs = Presentation("custom_template.pptx") slide = prs.slides.add_slide(prs.slide_layouts[10]) # 假设自定义布局索引为10
六、常见问题
Q1：为什么 slide.shapes.title 返回 None？
- 原因：当前布局无标题占位符
- 解决：换用含标题的布局（如索引0/1/5），或手动添加文本框
Q2：如何调整占位符位置？
- 通过
placeholder.element.getparent().remove()删除原有占位符 - 用
add_textbox()或add_picture()自定义位置
Q3：布局与主题的关系？
- 布局依赖于主题（Theme），更换主题可能影响占位符样式