文档控件Spire.Doc教程：使用 Python 创建 Word 文档的详细指南

摘要：以编程方式创建 Word 文档是实现任务自动化、生成报告或制作专业文档的一种强大方法。使用 Python，您可以访问大量库来帮助实现这一目标。Spire.Doc for Python就是这样一个库，它专门用于处理 Word 文档。在本文中，我们将探讨如何使用S

以编程方式创建 Word 文档是实现任务自动化、生成报告或制作专业文档的一种强大方法。使用 Python，您可以访问大量库来帮助实现这一目标。Spire.Doc for Python就是这样一个库，它专门用于处理 Word 文档。在本文中，我们将探讨如何使用 Spire.Doc for Python 高效地创建和处理 Word 文档。

Spire.Doc for Python试用下载

为何选择 Spire.Doc for Python？

在深入了解技术细节之前，有必要先了解一下 Spire.Doc for Python 为什么能在众多库中脱颖而出。以下是一些关键原因：

操作简便：提供直观的 API，简化 Word 文档的创建与修改流程。

功能丰富：支持文本、图片、表格等多种元素的添加与编辑。

跨平台兼容：可在不同操作系统上无缝运行，适合多样化开发需求。

强大支持：拥有活跃的社区和详尽的文档，确保问题快速解决。

Spire.Doc for Python 入门

开始创建 Word 文档前，需完成环境配置：

安装库：通过 pip 安装 Spire.Doc for Python：

pip install spire.doc

导入模块：安装完成后，在 Python 脚本中导入所需模块

from spire.doc import *from spire.doc.common import *

创建空白 Word 文档

使用 Spire.Doc 的第一步是新建一个 Word 文档，具体操作如下：

# 创建一个文档对象doc = Document# 添加一个章节section = doc.AddSection# 设置页面大小和边距section.PageSetup.PageSize = PageSize.A4section.PageSetup.Margins.Top = 60section.PageSetup.Margins.Bottom = 60# 保存文档doc.SaveToFile("MyDocument.docx")doc.Dispose

这段代码会创建一个空白的 Word 文档，并保存为 "MyDocument.docx" 文件。您可以在 Microsoft Word 或其他兼容应用程序中打开该文件。

添加标题、子标题和段落

有了空白文档后，下一步就是添加内容。Spire.Doc 可以轻松插入标题、段落和文本内容：

1.添加标题

# 添加标题paragraph = section.AddParagraphtextRange = paragraph.AppendText("我的第一份文档")paragraph.ApplyStyle(BuiltinStyle.Title)# 自定义字体样式textRange.CharacterFormat.FontName = "宋体"textRange.CharacterFormat.FontSize = 24

2.添加子标题

# 添加一个标题paragraph = section.AddParagraphtextRange = paragraph.AppendText("这是标题1")paragraph.ApplyStyle(BuiltinStyle.Heading1)# 自定义字体样式textRange.CharacterFormat.FontName = "宋体"textRange.CharacterFormat.FontSize = 16

3.添加段落

# 添加一个段落paragraph = section.AddParagraphtextRange = paragraph.AppendText("这是我文档的第一段。")paragraph.ApplyStyle(BuiltinStyle.Normal)# 自定义字体样式textRange.CharacterFormat.FontName = "宋体"textRange.CharacterFormat.FontSize = 12

4.设置文本样式

默认情况下，标题会居中显示，子标题和段落则左对齐，并且都采用默认字体和字号。如需自定义样式，可通过CharacterFormat属性进行调整，如上文代码示例所示。

当然，您也可以通过ParagraphStyle创建段落样式，再将其应用到指定段落。具体代码如下：

# 定义段落样式style = ParagraphStyle(doc)style.Name = "paraStyle"style.CharacterFormat.FontName = "宋体"style.CharacterFormat.FontSize = 13doc.Styles.Add(style)# 应用样式到指定段落paragraph.ApplyStyle("paraStyle")

通过使用这些方法，您可以用适当的标题和小标题来安排文档的结构，使其更具可读性。

在文档中插入图片

在 Word 文档中加入图片可以使文档更具视觉吸引力。下面介绍如何使用 Spire.Doc 添加图片：

1.从本地插入图片

paragraph = section.AddParagraphpicture = paragraph.AppendPicture("C:\\Users\\Administrator\\Desktop\\logo.png")

2.从网络插入图片

# 从 URL 下载图片image_url = "https://example.com/image.png"response = requests.get(image_url)# 保存为临时文件temp_image_path = "temp_image.png"with open(temp_image_path, 'wb') as file: file.write(response.content)# 插入到文档中paragraph = section.AddParagraphparagraph.AppendPicture(temp_image_path)

这段代码依赖于requests库，该库用于发送访问网络资源的 HTTP 请求。请确保将其导入到您的项目中。

3.高级图片设置

# 调整图片大小picture.Width = picture.Width * 0.8picture.Height = picture.Height * 0.8# 图片居中对齐paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center

在文档中添加表格

表格是以结构化格式呈现数据的绝佳方式。下面介绍如何在文档中添加一个简单的普通表格：

# 添加表格table = section.AddTable(True)# 添加一行row = table.AddRow(False, 3)row.Cells[0].AddParagraph.AppendText("第1行，第1列")row.Cells[1].AddParagraph.AppendText("第1行，第2列")row.Cells[2].AddParagraph.AppendText("第1行，第3列")# 添加另一行row = table.AddRow(False, 3)row.Cells[0].AddParagraph.AppendText("第2行，第1列")row.Cells[1].AddParagraph.AppendText("第2行，第2列")row.Cells[2].AddParagraph.AppendText("第2行，第3列")

Spire.Doc 提供多种创建和自定义表格的选项。有关详细信息，请参阅：如何使用 Python 在 Word 文档中创建表格。

在文档中添加列表

列表是一种有效的组织工具，能以结构化和易于理解的方式呈现信息。下面介绍如何在文档中添加编号列表和项目符号列表：

1.插入编号列表

# 创建编号列表样式listStyle = ListStyle(doc, ListType.Numbered)listStyle.Name = "numberedList"listStyle.Levels[0].PatternType = ListPatternType.ArabiclistStyle.Levels[0].TextPosition = 20doc.ListStyles.Add(listStyle)# 创建编号列表for item in ["第一项", "第二项", "第三项"]:paragraph = section.AddParagraphparagraph.AppendText(item)paragraph.ListFormat.ApplyStyle("numberedList")

2.插入项目符号列表

# 创建项目符号列表样式listStyle = ListStyle(doc, ListType.Bulleted)listStyle.Name = "bulletedList"listStyle.Levels[0].BulletCharacter = "\u00B7"listStyle.Levels[0].CharacterFormat.FontName = "Symbol"listStyle.Levels[0].TextPosition = 20doc.ListStyles.Add(listStyle)# 创建项目符号列表for item in ["项目一", "项目二", "项目三"]:paragraph = section.AddParagraphparagraph.AppendText(item)paragraph.ListFormat.ApplyStyle("bulletedList")

以下是根据上述代码段生成的 Word 文档截图：