python-docx 使用教程

打开文档

你需要的第一件事是工作的文档。最简单的方法是：

1 2 3

from docx import Document document = Document()

这将打开一个基于默认“模板”的空白文档，您可以打开并使用现有的Word文档的工作python-docx，我们会让事情变得简单。

增加一段

段落是Word的基础。它们用于正文文本，但也用于标题和列表项目（如项目符号）。

这里是添加一个最简单的方法：

1	paragraph = document.add_paragraph('Lorem ipsum dolor sit amet.')

此方法返回对段落的引用，新添加的段落在文档的结尾。新的段落引用被分配给paragraph 在这种情况下，我将要离开了这一点在下面的例子中，除非我有一个需要它。在你的代码中，通常你不会对项目做任何事情，在添加它，所以没有什么意义，保持引用它挂在周围。

还可以使用一个段落作为“光标”，并在其上直接插入一个新段落：

1	prior_paragraph = paragraph.insert_paragraph_before('Lorem ipsum')

这允许将一个段落插入到文档的中间，这在修改现有文档时通常很重要，而不是从头开始生成。

添加标题

在除了最短文档之外的任何内容中，正文文本被分成多个部分，每个部分以一个标题开始。以下是如何添加一个：

1	document.add_heading('The REAL meaning of the universe')

默认情况下，这会添加顶级标题，Word中显示为“标题1”。当您需要子节的标题时，只需指定所需的级别为1到9之间的整数：

1	document.add_heading('The role of dolphins', level=2)

如果指定级别0，将添加“标题”段落。这可以方便地启动一个相对较短的文档，没有单独的标题页。

添加分页符

每隔一段时间，你想要下一个文本在一个单独的页面，即使你所在的一个不是满的。“hard”分页符可以做到这一点：

1	document.add_page_break()

如果你发现自己经常使用它，这可能是一个标志，你可以通过更好地了解段落样式受益。可设置的一个段落样式属性是在包含该样式的每个段落之前立即断开页面。因此，您可以将标题设置为某个级别，以便始终启动新页面。更多风格后。它们对于真正充分利用Word至关重要。

添加表

一个经常遇到的内容，它自己的表格呈现，排列在整齐的行和列。Word在这方面做得相当不错。以下是添加表格的方法：

1	table = document.add_table(rows=2, cols=2)

表具有几个