如何在 Python 中创建演示文稿

Aspose.Slides FOSS for Python 让您完全在 Python 中创建 PowerPoint 演示文稿，无需依赖 Microsoft Office。本指南展示了如何创建新演示文稿、添加幻灯片和形状、格式化文本以及保存结果。

分步指南

步骤 1：安装软件包

从 PyPI 安装 Aspose.Slides FOSS。需要 Python 3.10 或更高版本。

pip install aspose-slides-foss

验证安装：

import aspose.slides_foss as slides
print("Aspose.Slides FOSS ready")

lxml 依赖会自动安装。无需其他系统软件包。

步骤 2：导入所需模块

导入用于保存所需的包和 SaveFormat 枚举。

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
from aspose.slides_foss import ShapeType

所有形状类型常量位于 aspose.slides_foss.ShapeType。所有格式类型（FillType，NullableBool）也位于 aspose.slides_foss。

步骤 3：创建演示文稿

使用 slides.Presentation() 作为上下文管理器。新演示文稿以一个空白幻灯片开始。

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    print(f"Slides in new presentation: {len(prs.slides)}")
    # work with prs inside this block
    prs.save("output.pptx", SaveFormat.PPTX)

重要： 始终在 with 块内打开并使用 Presentation。不要在 with 语句之外存储引用；资源将无法正确释放。

步骤 4：访问幻灯片

第一张幻灯片的索引是 0。空白演示文稿恰好有一张幻灯片。

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]  # zero-based index
    print(f"Slide at index 0: {slide}")
    prs.save("output.pptx", SaveFormat.PPTX)

步骤 5：添加形状

使用 slide.shapes.add_auto_shape() 添加 AutoShape。参数为 (shape_type, x, y, width, height)，全部以点为单位（1 点 = 1/72 英寸；标准幻灯片为 720 × 540 pt）。

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Rectangle at (50, 50) with 400 wide and 120 tall
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 120)

    # Attach a text frame
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")

    prs.save("with-shape.pptx", SaveFormat.PPTX)

第6步：保存演示文稿

在 with 块退出之前调用 prs.save(path, SaveFormat.PPTX)。PPTX 是唯一受支持的输出格式。

prs.save("result.pptx", SaveFormat.PPTX)

文件以原子方式写入；如果在此调用之前发生错误，则不会创建输出文件。

完整工作示例

以下脚本创建了一个包含两张幻灯片的演示文稿，第一张幻灯片上有标题形状，第二张幻灯片上有表格。

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    # --- Slide 1: title shape ---
    slide1 = prs.slides[0]
    title = slide1.shapes.add_auto_shape(ShapeType.RECTANGLE, 40, 40, 640, 80)
    tf = title.add_text_frame("Q1 Results: Executive Summary")
    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 32
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)

    # --- Slide 2: table ---
    prs.slides.add_empty_slide(prs.layout_slides[0])
    slide2 = prs.slides[1]
    table = slide2.shapes.add_table(40, 40, [200.0, 120.0, 120.0], [40.0, 40.0, 40.0])
    headers = ["Region", "Revenue", "Growth"]
    data = [
        ["North", "$1.2M", "+8%"],
        ["South", "$0.9M", "+4%"],
    ]
    for col, header in enumerate(headers):
        table.rows[0][col].text_frame.text = header
    for row_idx, row_data in enumerate(data):
        for col, cell_text in enumerate(row_data):
            table.rows[row_idx + 1][col].text_frame.text = cell_text

    prs.save("q1-results.pptx", SaveFormat.PPTX)

print("Saved q1-results.pptx")

常见问题及解决方案

ResourceWarning: unclosed Presentation

您正在实例化 Presentation 而未使用 with 块。始终使用：

with slides.Presentation() as prs:
    ...

AttributeError: __enter__

如果您看到此错误，请检查您导入的是 aspose.slides_foss（而不是 aspose.slides）。PyPI 上的包名是 aspose-slides-foss，运行时导入是 aspose.slides_foss。

TypeError: SaveFormat.PPTX is not callable

SaveFormat.PPTX 是枚举成员，而不是函数。请将其用作 prs.save("file.pptx", SaveFormat.PPTX)。

常见问题

默认幻灯片尺寸是多少？

新的 Presentation() 会在标准的 10 × 7.5 英寸（720 × 540 点）尺寸创建幻灯片。此版本尚不支持更改幻灯片尺寸。

我可以添加多个幻灯片吗？

是的。调用 prs.slides.add_empty_slide(prs.layout_slides[0]) 来追加一个空白幻灯片并通过索引访问它：

prs.slides.add_empty_slide(prs.layout_slides[0])
slide2 = prs.slides[1]

我可以打开现有文件并添加幻灯片吗？

是：

with slides.Presentation("existing.pptx") as prs:
    prs.slides.add_empty_slide(prs.layout_slides[0])
    prs.save("existing.pptx", SaveFormat.PPTX)

我可以保存为哪些格式？

仅支持 SaveFormat.PPTX。此版本不提供导出为 PDF、HTML、SVG 或图像的功能。