python-pptx 的layout 布局-EW帮帮网

一、布局基础概念

在 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 Presentation

prs = 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 Inches

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

python-pptx 的layout 布局