如何使用 Python 创建 PowerPoint 文档

使用Python创建PowerPoint

在自动化办公场景中，使用 Python 编程生成 PowerPoint 文档能显著提升工作效率，特别适用于定期报告、产品演示等需要快速产出标准化幻灯片的场景。通过脚本自动化处理，用户可以将精力集中在内容创作和视觉设计上，而无需反复进行繁琐的手动排版操作。

本教程将详细介绍如何使用 Spire.Presentation for Python 在 Python 中实现 PPT/PPTX 文件的自动化生成与编辑。该库为开发者提供了一套完整的 API 接口，支持对演示文稿进行全功能编程控制。

目录：

Python 操作 PowerPoint 文档的库
安装 Spire.Presentation for Python
从零开始创建PPT文档
基于模板快速生成 PPT 演示文档
Python 自动化生成 PPT 的最佳实践
总结
常见问题解答

1. Python 操作 PowerPoint 文件的库

Spire.Presentation 是一个功能强大的 Python 库，无需安装 Microsoft Office 即可实现 PPT 文件的创建、读取和修改。该库主要支持以下功能：

从空白文档或模板创建 PowerPoint 文件
添加文本、图片、列表、表格、图表和形状
自定义字体、颜色、背景和版式布局
支持保存或导出为 PPT/PPTX 格式，或转换为 PDF/图片

接下来的章节中，我们将逐步讲解如何安装该库、创建演示文稿，以及为幻灯片添加各种元素。

2. 安装 Spire.Presentation for Python

开始前，您需要先安装 Spire.Presentation 库。可以通过 pip 命令进行安装：

pip install spire.presentation

安装完成后，您就可以在 Python 脚本中使用该库的功能来创建 PowerPoint 文档了。

3. 从零开始创建 PPT 文档

3.1 生成并保存空白演示文稿

让我们从创建一个基础 PowerPoint 演示文稿开始。以下代码示例展示了如何生成并保存一个空白的演示文稿：

from spire.presentation.common import *
from spire.presentation import *

# 创建一个Presentation对象
presentation = Presentation()

# 设置幻灯片大小类型
presentation.SlideSize.Type = SlideSizeType.Screen16x9

# 添加一张幻灯片（默认文档中有一张幻灯片）
presentation.Slides.Append()

# 将文档保存为 PPT 或 PPTX 文件
presentation.SaveToFile("BlankPowerPoint.pptx", FileFormat.Pptx2019)
presentation.Dispose()

在本段代码中：

Presentation ：表示PowerPoint文件的根类。
SlideSize.Type ：设置幻灯片尺寸（如SlideSizeType.Screen16x9表示宽屏比例）。
Slides.Append() ：向演示文稿添加新幻灯片（默认已包含一张初始幻灯片）。
SaveToFile() ：将演示文稿保存为指定格式（本例为PPTX格式）。

3.2添加基础元素到幻灯片

现在我们已经创建了空白演示文稿，接下来将学习如何添加文本、图片、列表和表格等基础元素。

添加格式化文本

文本是幻灯片最常见的元素之一，在幻灯片中添加带格式的文本可以增强信息传达的清晰度和视觉吸引力。您可以使用以下代码来实现文本的插入和格式设置：

# 获取第一张幻灯片
first_slide = presentation.Slides[0]

# 向幻灯片添加一个形状
rect = RectangleF.FromLTRB(30, 60, 900, 150)
shape = first_slide.Shapes.AppendShape(ShapeType.Rectangle, rect)
shape.ShapeStyle.LineColor.Color = Color.get_Transparent()
shape.Fill.FillType = FillFormatType.none

# 向形状中添加文本
shape.AppendTextFrame("本指南演示如何使用 Python 创建 PowerPoint 文档")

# 获取形状的文本作为文本范围
textRange = shape.TextFrame.TextRange

# 设置字体名称、样式（粗体和斜体）、大小和颜色
textRange.LatinFont = TextFont("宋体")
textRange.IsBold = TriState.TTrue
textRange.FontHeight = 32
textRange.Fill.FillType = FillFormatType.Solid
textRange.Fill.SolidColor.Color = Color.get_Black()

# 设置对齐方式
textRange.Paragraph.Alignment = TextAlignmentType.Left

在本段代码中：

AppendShape() ：在幻灯片上添加形状（此处创建了一个矩形框作为文本容器）。
AppendTextFrame() ：为形状添加文本框，用于插入文字内容。
TextFrame.TextRange ：获取文本范围对象，可进行字体样式、大小和颜色等细节设置。
Paragraph.Alignment ：设置文本在形状内的对齐方式（左对齐/居中/右对齐）。

添加图片

在幻灯片中添加公司 Logo 等图片可以提升专业性和品牌识别。您可以使用以下代码将图片插入到演示文稿中：

# 获取第一张幻灯片
first_slide = presentation.Slides[0]

# 加载图像文件
imageFile = "C:\\Users\\Administrator\\Desktop\\logo.png"
stream = Stream(imageFile)
imageData = presentation.Images.AppendStream(stream)

# 重置大小
width = imageData.Width * 0.6
height = imageData.Height * 0.6

# 将其添加到幻灯片
rect = RectangleF.FromLTRB(750, 50, 750 + width, 50 + height)
image = first_slide.Shapes.AppendEmbedImageByImageData(ShapeType.Rectangle, imageData, rect)
image.Line.FillType = FillFormatType.none

在本段代码中：

Stream() ：根据图片路径创建数据流。
AppendStream() ：将图片数据存入演示文稿的图像集合。
AppendEmbedImageByImageData() ：按指定坐标位置将图片嵌入幻灯片。

您可能感兴趣: 使用 Python 在 PowerPoint 文档中添加形状

添加列表

项目符号列表有助于清晰地展示信息结构。您可以使用以下代码来实现这一功能：

# 获取第一张幻灯片
first_slide = presentation.Slides[0]

# 指定列表边界和内容
listBounds = RectangleF.FromLTRB(30, 150, 500, 350)
listContent = [
    "第 1 步：安装 Spire.Presentation for Python。",
    "第 2 步：创建一个演示文稿对象。",
    "第 3 步：向幻灯片添加文本、图像等。",
    "第 4 步：设置背景图像或颜色。",
    "第 5 步：将演示文稿保存为 PPT(X) 文件。"
]

# 添加一个形状
autoShape = first_slide.Shapes.AppendShape(ShapeType.Rectangle, listBounds)
autoShape.TextFrame.Paragraphs.Clear()
autoShape.Fill.FillType = FillFormatType.none
autoShape.Line.FillType = FillFormatType.none

for content in listContent:
    # 根据列表内容创建段落并将其添加到形状中
    paragraph = TextParagraph()
    autoShape.TextFrame.Paragraphs.Append(paragraph)
    paragraph.Text = content
    paragraph.TextRanges[0].Fill.FillType = FillFormatType.Solid
    paragraph.TextRanges[0].Fill.SolidColor.Color = Color.get_Black()
    paragraph.TextRanges[0].FontHeight = 20
    paragraph.TextRanges[0].LatinFont = TextFont("宋体")

    # 为这些段落设置项目符号类型
    paragraph.BulletType = TextBulletType.Symbol

    # 设置行间距
paragraph.LineSpacing = 150

在这段代码中：

AppendShape() ：为列表创建一个矩形形状。
TextFrame.Paragraphs.Append() ：为每个列表项添加段落。
BulletType ：设置列表项的项目符号样式。

添加表格

表格在幻灯片中可以有效地组织和展示数据。您可以使用以下代码来实现这一操作：

# 获取第一张幻灯片
first_slide = presentation.Slides[0]

# 定义表格的尺寸和数据
widths = [200, 200, 200]
heights = [18, 18, 18, 18]
dataStr = [
    ["幻灯片编号", "标题", "内容类型"], 
    ["1", "介绍", "文本/图像"], 
    ["2", "项目概述", "图表/图形"],  
    ["3", "关键发现", "文本/列表"]
]

# 将表格添加到幻灯片
table = first_slide.Shapes.AppendTable(30, 360, widths, heights)

# 用数据填充表格并应用格式
for rowNum, rowData in enumerate(dataStr):
    for colNum, cellData in enumerate(rowData):  
        cell = table[colNum, rowNum]
        cell.TextFrame.Text = cellData
        
        textRange = cell.TextFrame.Paragraphs[0].TextRanges[0]
        textRange.LatinFont = TextFont("宋体")
        textRange.FontHeight = 19
        
        cell.TextFrame.Paragraphs[0].Alignment = TextAlignmentType.Center

# 应用内置的表格样式
table.StylePreset = TableStylePreset.MediumStyle2Accent1

在这段代码中：

AppendTable() ：在指定坐标处将表格添加到幻灯片，并定义列和行的宽度和高度
Cell.TextFrame.Text ：为表格中的每个单元格设置文本。
StylePreset ：为表格应用预定义样式，以增强美观性。

3.3 应用背景图像或颜色

为幻灯片设置自定义背景可以提升视觉效果和整体设计。您可以使用以下代码设置背景图片：

# 获取第一张幻灯片
first_slide = presentation.Slides[0]

# 获取第一张幻灯片的背景
background = first_slide.SlideBackground

# 从指定的图像文件创建一个流
stream = Stream("C:\\Users\\Administrator\\Desktop\\background.jpg")
imageData = presentation.Images.AppendStream(stream)

# 将图像设置为背景 
background.Type = BackgroundType.Custom
background.Fill.FillType = FillFormatType.Picture
background.Fill.PictureFill.FillType = PictureFillType.Stretch
background.Fill.PictureFill.Picture.EmbedImage = imageData

在这段代码中：

SlideBackground ：访问幻灯片的背景属性。
Fill.FillType ：指定填充的类型（在这种情况下为图像）。
PictureFill.FillType ：设置背景图像的显示方式（在此情况下为拉伸）。
Picture.EmbedImage ：为背景设置图像数据。

有关更多背景选项，请参考本教程：Python 为 PowerPoint 幻灯片设置背景颜色或图片

效果图：

以下是由上述代码片段生成的 PowerPoint 文档的截图。

使用Python创建的PPT文档

4. 基于模板快速生成PPT演示文档

使用模板可以快速生成标准化的演示文稿，只需替换预置的占位符即可完成个性化定制。这种方法特别适合需要批量生成或定期更新的场景，例如项目报告、销售提案等。以下是基于模板动态生成 PowerPoint 文档的完整示例：

from spire.presentation.common import *
from spire.presentation import *

# Create a Presentation object
presentation = Presentation()

# Load a PowerPoint document from a specified file path
presentation.LoadFromFile("C:\\Users\\Administrator\\Desktop\\template.pptx")

# Get a specific slide from the presentation
slide = presentation.Slides[0]

# Define a list of replacements where each tuple consists of the placeholder and its corresponding replacement text
replacements = [
    ("{project_name}", "寰宇太阳能计划"),
    ("{budget}", "250万元"),
    ("{status}", "进行中（65% 完成）"),
    ("{start_date}", "2023年3月15日"),
    ("{end_date}", "2024年11月30日"),
    ("{manager}", "张三"),
    ("{client}", "寰宇科技有限公司")
]

# Iterate through each replacement pair
for old_string, new_string in replacements:

    # Replace the first occurrence of the old string in the slide with the new string
    slide.ReplaceFirstText(old_string, new_string, False)

# Save the modified presentation to a new file
presentation.SaveToFile("Template-Based.pptx", FileFormat.Pptx2019)
presentation.Dispose()

在这段代码中：

LoadFromFile() ：加载作为模板的现有 PowerPoint 文件。
ReplaceFirstText() ：用实际值替换幻灯片中的占位符。这对于动态内容生成非常有用。
SaveToFile() ：将修改后的演示文稿保存为新文件。

效果图：

Python根据模板生成PPT文档

5. Python 自动化生成 PPT 的最佳实践

在使用 Python 创建 PowerPoint 演示文稿时，请考虑以下最佳实践：

保持一致性 ：确保所有幻灯片的格式（字体、颜色、样式）保持一致，以呈现专业的外观。-
模块化代码 ：将文档生成拆分为函数（例如 add_list()、insert_image()），以提高可重用性。
优化图像 ：在将图像添加到演示文稿之前，调整大小并压缩图像，以减少文件大小并提高加载速度。
使用模板 ：尽可能使用模板，以节省时间并保持设计的一致性。
测试代码 ：始终测试您的演示文稿生成代码，以确保所有元素正确添加并按预期显示。

6. 总结

在本教程中，我们探讨了如何使用Spire.Presentation for Python库 在 Python 中创建 PowerPoint 文档 。从类库安装、基础文档创建，到文本样式控制、图片插入、表格制作等元素编排，再到模板应用等高级功能，本教程通过具体代码示例帮助开发者快速掌握各项操作技巧。这些方法能显著提升PPT制作效率，特别适用于需要定期生成标准化文档的工作场景。

7. 常见问题解答

Q1. 什么是 Spire.Presentation？

Spire.Presentation 是一个强大的库，用于在多种编程语言中创建、读取和修改 PowerPoint 文件，包括 Python。

Q2. 这个库需要安装 Microsoft Office 吗？

不，Spire.Presentation 可独立运行，无需安装 Microsoft Office。

Q3. 我可以自定义演示文稿中幻灯片的布局吗？

是的，您可以通过以下方式完全自定义每张幻灯片的版式：

尺寸调整：修改幻灯片页面大小（如A4/16:9等比例）。
背景定制：设置纯色/渐变/图片背景。
元素布局：自由调整形状、文本框、图片等对象的位置与层级关系。

Q4. Spire.Presentation 是否支持 PPT 和 PPTX 格式？

是的，Spire.Presentation 支持 PPT 和 PPTX 格式。您可以在保存时通过 FileFormat 参数自由选择输出格式，例如：

# 保存为PPTX格式（推荐）
presentation.SaveToFile("output.pptx", FileFormat.Pptx2019)

# 保存为PPT格式（兼容旧版）
presentation.SaveToFile("output.ppt", FileFormat.PPT)

Q5. 我可以在演示文稿中添加图表吗？

可以，Spire.Presentation 支持在幻灯片中添加图表，使您能够有效地可视化数据。有关详细说明，请参考：使用 Python 在 PowerPoint 中创建柱形图

申请临时License

如果您需要去除生成文档中的评估提示或解除功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。