Python 使用 python-pptx 库实现 PPT 自动化生成与编辑

4. 使用模板生成 PPT

加载现有模板文件，保留原有样式，仅替换数据内容。这适用于生成标准化的报告。

from pptx import Presentation
from pptx.util import Cm
from pptx.chart.data import ChartData
from pptx.enum.chart import XL_CHART_TYPE, XL_LEGEND_POSITION

# 加载模板文件
prs = Presentation('template.pptx')

# 添加新幻灯片
slide = prs.slides.add_slide(prs.slide_layouts[5])
shapes = slide.shapes

# 设置标题
shapes.title.text = 'Monthly Report'

# 准备表格数据
name_objects = ["Object A", "Object B", "Object C"]
val_data = [(19.2, 21.4, 16.7), (22.3, 28.6, 15.2), (20.4, 26.3, 14.2)]

# 添加表格
rows, cols = 4, 4
table = shapes.add_table(rows, cols, Cm(3.5), Cm(12.5), Cm(24), Cm(6)).table

# 填充表头
table.cell(0, 1).text = name_objects[0]
table.cell(0, 2).text = name_objects[1]
table.cell(0, 3).text = name_objects[2]

# 填充数据行
for i, val in enumerate(val_data):
    table.cell(i + 1, 0).text = f"AI_{i+1}"
    for j, v in enumerate(val):
        table.cell(i + 1, j + 1).text = str(v)

# 添加图表
chart_data = ChartData()
chart_data.categories = name_objects
for i, val in enumerate(val_data):
    chart_data.add_series(f"Series {i+1}", val)

x, y, cx, cy = Cm(3.5), Cm(4.2), Cm(24), Cm(8)
graphic_frame = slide.shapes.add_chart(
    XL_CHART_TYPE.COLUMN_CLUSTERED, x, y, cx, cy, chart_data
)

chart = graphic_frame.chart
chart.has_legend = True
chart.legend.position = XL_LEGEND_POSITION.TOP

prs.save('report_from_template.pptx')

5. 修改现有 PPT 文件

除了新建，我们常需修改已有文件。打开文件后遍历幻灯片进行修改，最后保存。

from pptx import Presentation

prs = Presentation('existing_file.pptx')

# 遍历所有幻灯片
for i, slide in enumerate(prs.slides):
    # 查找并修改标题
    if slide.shapes.title:
        slide.shapes.title.text = f"Slide {i + 1}: Modified"
    
    # 遍历形状以修改其他文本框
    for shape in slide.shapes:
        if hasattr(shape, "text") and shape.text:
            # 简单示例：将文本转为大写（实际场景可按需处理）
            pass

# 保存修改后的文件
prs.save('modified_file.pptx')

6. 文本样式与图片插入

6.1 设置字体样式

可以通过 text_frame.paragraphs[0].font 属性设置字体名称、大小、加粗及颜色。

from pptx.util import Pt
from pptx.dml.color import RGBColor

# 假设已获取到 title 对象
title = slide.shapes.title
run = title.text_frame.paragraphs[0].runs[0]
run.font.name = 'Microsoft YaHei'
run.font.size = Pt(24)
run.font.bold = True
run.font.color.rgb = RGBColor(0, 0, 255)  # 蓝色

6.2 插入图片

使用 add_picture 方法将本地图片插入到幻灯片中。

from pptx.util import Inches

img_path = 'logo.png'
left = Inches(1)
top = Inches(1)
width = Inches(2)
height = Inches(1)

slide.shapes.add_picture(img_path, left, top, width=width, height=height)

7. 最佳实践与注意事项

1. 备份原文件：在执行修改操作前，建议先备份原始 .pptx 文件，防止数据丢失。
2. 路径问题：确保代码运行目录下的文件路径正确，或使用绝对路径。
3. 资源释放：虽然 Python 会自动管理内存，但在处理大型 PPT 时，建议显式关闭对象或及时保存。
4. 兼容性：生成的文件基于 Open XML 标准，通常兼容 Microsoft Office 2007 及以上版本。

通过上述方法，您可以灵活地控制 PPT 的内容与结构，实现办公文档的批量自动化处理。