Python 使用 python-pptx 库自动化制作 PPT 教程

5. 插入图片

插入图片需要指定图片路径以及位置尺寸（单位通常为英寸 Inches）。

# 确保图片路径正确
img_path = 'image.jpg'

left = top = Inches(1)
width = Inches(4)
height = Inches(3)

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

6. 插入表格

表格需要指定行数和列数，以及位置和尺寸。

rows, cols = 3, 2
left, top = Inches(1), Inches(4)
width, height = Inches(6), Inches(2)

table = slide.shapes.add_table(rows, cols, left, top, width, height).table

# 填充单元格
for i in range(rows):
    for j in range(cols):
        table.cell(i, j).text = f'Row {i}, Col {j}'

完整示例代码

以下是一个完整的脚本示例，演示了如何从头创建一个包含标题页、内容页、图片和表格的 PPT。

from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.dml.color import RGBColor
import os

def create_ppt():
    # 初始化演示文稿
    prs = Presentation()
    
    # 1. 添加标题幻灯片
    title_slide_layout = prs.slide_layouts[0]
    slide = prs.slides.add_slide(title_slide_layout)
    title = slide.shapes.title
    subtitle = slide.shapes.placeholders[1]
    title.text = "Python 自动化 PPT 演示"
    subtitle.text = "Generated by python-pptx"
    
    # 2. 添加内容幻灯片
    content_slide_layout = prs.slide_layouts[1]
    slide = prs.slides.add_slide(content_slide_layout)
    
    # 设置标题
    title = slide.shapes.title
    title.text = "功能概览"
    
    # 设置正文
    body = slide.shapes.placeholders[1]
    tf = body.text_frame
    p = tf.paragraphs[0]
    p.text = "- 自动创建幻灯片"
    p.font.bold = True
    
    p = tf.add_paragraph()
    p.text = "- 自定义文本样式"
    p.level = 1
    
    p = tf.add_paragraph()
    p.text = "- 插入图片与表格"
    p.level = 1
    
    # 3. 添加图片幻灯片
    img_slide_layout = prs.slide_layouts[5] # 空白布局
    slide = prs.slides.add_slide(img_slide_layout)
    
    # 添加标题
    title = slide.shapes.add_textbox(Inches(1), Inches(0.5), Inches(6), Inches(1))
    title.text_frame.text = "图片展示区域"
    title.text_frame.paragraphs[0].font.size = Pt(24)
    title.text_frame.paragraphs[0].font.bold = True
    
    # 添加图片 (注意：实际运行时请确保图片存在，否则报错)
    if os.path.exists('logo.png'):
        slide.shapes.add_picture('logo.png', Inches(1), Inches(2), Inches(4), Inches(3))
    else:
        # 如果没有图片，添加一个矩形代替说明
        shape = slide.shapes.add_shape(1, Inches(1), Inches(2), Inches(4), Inches(3)) # 1 is msoShapeRectangle
        shape.fill.solid()
        shape.fill.fore_color.rgb = RGBColor(200, 200, 200)
        shape.text_frame.text = "图片占位符"
    
    # 4. 添加表格幻灯片
    table_slide_layout = prs.slide_layouts[5]
    slide = prs.slides.add_slide(table_slide_layout)
    
    title = slide.shapes.add_textbox(Inches(1), Inches(0.5), Inches(6), Inches(1))
    title.text_frame.text = "数据表格示例"
    title.text_frame.paragraphs[0].font.size = Pt(24)
    
    rows, cols = 3, 3
    table = slide.shapes.add_table(rows, cols, Inches(1), Inches(2), Inches(6), Inches(2)).table
    
    headers = ['项目', '状态', '进度']
    data = [
        ['任务 A', '进行中', '50%'],
        ['任务 B', '已完成', '100%'],
        ['任务 C', '未开始', '0%']
    ]
    
    for i, header in enumerate(headers):
        cell = table.cell(0, i)
        cell.text = header
        cell.text_frame.paragraphs[0].font.bold = True
        
    for i, row_data in enumerate(data):
        for j, val in enumerate(row_data):
            table.cell(i+1, j).text = val
    
    # 保存文件
    prs.save('final_report.pptx')
    print("PPT 生成成功！")

if __name__ == '__main__':
    create_ppt()

常见问题与注意事项

1. 路径问题：插入图片或加载模板时，务必使用绝对路径或在运行脚本时切换至正确的目录，避免找不到文件。
2. 版本兼容性：不同版本的 Office 对某些格式的支持可能不同，建议测试后导出。
3. 内存占用：处理超大 PPT（如几百页）时，建议在循环中及时释放对象或分批处理，防止内存溢出。
4. 异常处理：在生产环境中，建议在关键步骤（如文件写入、图片读取）增加 try-except 块以捕获错误。

总结

通过 python-pptx 库，开发者可以将繁琐的 PPT 制作工作转化为代码逻辑。这不仅适用于简单的文档生成，还可以结合数据分析结果自动生成报表。掌握这一技能能显著提升办公自动化水平，减少重复劳动。