一、布局基础概念

在 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. 自定义布局（需修改模板）

1. 在 PowerPoint 中设计自定义布局并保存为 .pptx 文件
2. 代码加载自定义模板：

   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），更换主题可能影响占位符样式