python-docx 详解

Python-docx 是一个 Python 用于创建 Microsoft Word (.docx) 文件的库。它可以创建包含文本、图片、表格、列表、样式及其它元素的 Word 文档。

使用 python-docx，可以通过代码动态地创建 Word 文档，而不需要手动打开 Word 并手动创建文档。不仅如此，python-docx 还可以处理并修改已存在的 Word 文档，例如修改文本内容、表格数据，添加图片和段落等等。

使用 python-docx，我们可以创建完成微软 Office 的电子文档，而不依赖人类的操作，比如报告、信函、契约等等。使用这个库，你可以轻松地将程序输出的文章转换为 Word 文档，并使其兼容于大部分使用 Word 的环境，非常方便。

此外，使用 python-docx 还可以轻松地操作 Word 样式。你可以通过代码创建、修改和选择所需的文本格式，使有机构标准的文档符合各种文件格式。
当然，python-docx 在处理大型文档时，可能会出现效率低下的问题，因为它只是 Python 生成的 Word 文档，在处理复杂的文本格式时，您需要进行更多的开发和调整来提高性能。

相关问题

python-docx中add_paragraph

### Python-docx `add_paragraph` 方法详解

#### 创建新段落并设置基本属性

通过 `Document.add_paragraph()` 可以向文档中添加新的段落。此函数接受两个参数：

- **text**: (可选) 要作为初始文本插入到段落中的字符串，默认为空。
- **style**: (可选) 应用于该段落样式的名称。

from docx import Document

# 初始化一个新的Word文档实例
document = Document()

# 添加一个带有默认样式的简单段落
simple_para = document.add_paragraph('这是一个简单的段落')

# 添加带指定样式的段落
styled_para = document.add_paragraph(
    '这是应用特定风格的段落', 
    style='Heading 1'
)

# 保存修改后的文档至磁盘
document.save('example.docx')

#### 设置段落格式化选项

对于更复杂的排版需求，可以进一步配置段落的具体表现形式，比如调整缩进量等特性[^2]。

from docx.shared import Inches, Pt

para_format = simple_para.paragraph_format
para_format.left_indent = Inches(0.5)        # 设定左侧缩进为半英寸
para_format.first_line_indent = Inches(-0.2)  # 首行缩进减去两分之一英寸实现悬挂效果
para_format.line_spacing = 1.5                # 行距设为一点五倍行高
para_format.space_after = Pt(6)               # 段落后留白六磅

上述代码展示了如何利用 `ParagraphFormat` 对象来精细化控制所创建段落的各项视觉特征。