### python-docx 库处理 Word 文档的使用指南 `python-docx` 是一个用于读取、查询和修改 Microsoft Word 2007/2008 `.docx` 文件的 Python 库[^1]。以下是关于如何使用 `python-docx` 来创建和操作 Word 文档的详细说明。 #### 1. 创建一个新的 Word 文档 以下是一个简单的代码示例，展示如何使用 `python-docx` 创建一个包含标题和段落的基本 Word 文档： ```python from docx import Document # 创建新文档 doc = Document() # 添加标题 doc.add_heading('Python生成的Word文档', level=1) # 添加段落 doc.add_paragraph('这是一个使用python-docx库创建的Word文档。') # 添加带格式的文本 p = doc.add_paragraph() p.add_run('加粗文本').bold = True p.add_run(' 和 ') p.add_run('斜体文本').italic = True # 保存文档 doc.save('demo.docx') print("Word文档已生成") ``` 上述代码将生成一个名为 `demo.docx` 的 Word 文档，并在其中添加标题、普通段落以及带有格式（加粗和斜体）的文本[^3]。 #### 2. 读取现有的 Word 文档 若要读取现有的 `.docx` 文件并提取其内容，可以使用以下代码： ```python from docx import Document # 打开现有文档 doc = Document('example.docx') # 遍历文档中的所有段落 for para in doc.paragraphs: print(para.text) ``` 此代码会打印出 `example.docx` 文件中所有段落的内容。 #### 3. 修改现有的 Word 文档 如果需要对现有的 Word 文档进行修改，可以先打开该文档，然后添加或修改内容后再保存： ```python from docx import Document # 打开现有文档 doc = Document('example.docx') # 添加新的段落 doc.add_paragraph('这是新增的一段内容。') # 修改第一个段落的内容 if len(doc.paragraphs) > 0: doc.paragraphs[0].text = '这是修改后的内容。' # 保存修改后的文档 doc.save('modified_example.docx') ``` 这段代码会在 `example.docx` 中添加一段新内容，并修改文档的第一个段落，最后将修改结果保存为 `modified_example.docx`。 #### 4. 插入表格 `python-docx` 还支持插入表格功能。以下是如何创建一个简单的表格： ```python from docx import Document doc = Document() # 创建一个 3 行 3 列的表格 table = doc.add_table(rows=3, cols=3) # 填充表格内容 table.cell(0, 0).text = "行1列1" table.cell(0, 1).text = "行1列2" table.cell(0, 2).text = "行1列3" table.cell(1, 0).text = "行2列1" table.cell(1, 1).text = "行2列2" table.cell(1, 2).text = "行2列3" table.cell(2, 0).text = "行3列1" table.cell(2, 1).text = "行3列2" table.cell(2, 2).text = "行3列3" doc.save('table_example.docx') ``` 以上代码将生成一个包含 3 行 3 列表格的 Word 文档。 #### 5. 使用模板生成复杂文档 对于需要频繁生成类似结构的复杂文档，可以考虑结合 `python-docx-template` 使用。通过将 `.docx` 文件转换为 Jinja2 模板，能够更高效地生成文档[^2]。 --- ###