大家好，今天为大家分享一个超厉害的 Python 库 - python-docx。

Github地址：https://github.com/python-openxml/python-docx

在日常工作中，处理和生成 Word 文档是一个常见的需求。Python 提供了一个强大的库 python-docx，使得操作 Word 文档变得简单和高效。python-docx 可以帮助我们创建、修改和读取 Word 文档，适用于各种应用场景，如自动化报告生成、批量文档处理等。本文将详细介绍 python-docx 库，包括其安装方法、主要特性、基本和高级功能，以及实际应用场景，帮助全面了解并掌握该库的使用。

安装

要使用 python-docx 库，首先需要安装它。以下是安装步骤：

使用 pip 安装

可以通过 pip 直接安装 python-docx：

pip install python-docx

确认安装

安装完成后，可以通过以下命令确认安装是否成功：

python -c "import docx; print(docx.__version__)"

特性

1. 创建和修改文档：可以从头创建一个新的 Word 文档或修改现有的文档。
2. 支持多种格式：支持文本的各种格式设置，包括字体、大小、颜色、对齐方式等。
3. 图像和表格：可以在文档中插入和操作图像和表格。
4. 段落和标题：支持添加段落和标题，结构化文档内容。
5. 灵活扩展：通过提供的 API，可以灵活地进行自定义扩展，满足特定需求。

基本功能

创建和保存文档

可以使用 python-docx 创建一个新的 Word 文档并保存：

from docx import Document# 创建一个新的文档doc = Document()# 添加标题和段落doc.add_heading('Document Title', level=1)doc.add_paragraph('This is a paragraph in the document.')# 保存文档doc.save('example.docx')

打开和修改文档

可以打开一个现有的 Word 文档并进行修改：

from docx import Document# 打开现有文档doc = Document('existing.docx')# 添加新的段落doc.add_paragraph('This is a new paragraph.')# 保存修改后的文档doc.save('modified.docx')

设置文本格式

可以设置段落中的文本格式，包括字体、大小、颜色等：

from docx import Documentfrom docx.shared import Pt, RGBColordoc = Document()run = doc.add_paragraph().add_run('Formatted Text')# 设置字体、大小和颜色run.font.name = 'Arial'run.font.size = Pt(12)run.font.color.rgb = RGBColor(255, 0, 0)doc.save('formatted.docx')

插入图片

可以在文档中插入图片：

from docx import Documentdoc = Document()doc.add_heading('Document with Image', level=1)# 插入图片doc.add_picture('image.png', width=docx.shared.Inches(4))doc.save('document_with_image.docx')

添加表格

可以在文档中添加表格并填充数据：

from docx import Documentdoc = Document()table = doc.add_table(rows=2, cols=2)# 填充表格数据table.cell(0, 0).text = 'Header 1'table.cell(0, 1).text = 'Header 2'table.cell(1, 0).text = 'Cell 1'table.cell(1, 1).text = 'Cell 2'doc.save('table.docx')

高级功能

设置段落样式

可以为段落设置样式，以统一文档的格式：

from docx import Documentdoc = Document()paragraph = doc.add_paragraph('Styled Paragraph')paragraph.style = 'Title'  # 使用内置样式doc.save('styled_paragraph.docx')

添加页眉和页脚

可以在文档中添加页眉和页脚：

from docx import Documentdoc = Document()# 添加页眉header = doc.sections[0].headerheader.paragraphs[0].text = 'This is the header'# 添加页脚footer = doc.sections[0].footerfooter.paragraphs[0].text = 'This is the footer'doc.save('header_footer.docx')

设置段落格式

可以设置段落的对齐方式、缩进和间距等格式：

from docx import Documentfrom docx.enum.text import WD_ALIGN_PARAGRAPHdoc = Document()paragraph = doc.add_paragraph('Aligned Paragraph')paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER  # 居中对齐# 设置段落间距和缩进paragraph_format = paragraph.paragraph_formatparagraph_format.space_before = Pt(12)paragraph_format.space_after = Pt(12)paragraph_format.left_indent = Pt(24)doc.save('formatted_paragraph.docx')

操作复杂表格

可以操作和修改复杂的表格，设置单元格样式和合并单元格：

from docx import Documentdoc = Document()table = doc.add_table(rows=3, cols=3)# 合并单元格cell = table.cell(0, 0)cell.merge(table.cell(0, 2))# 设置单元格样式cell.text = 'Merged Cell'cell.paragraphs[0].runs[0].font.bold = Truecell.paragraphs[0].alignment = WD_ALIGN_PARAGRAPH.CENTERdoc.save('complex_table.docx')

实际应用场景

自动化报告生成

在数据分析或业务管理中，通过 python-docx 自动生成和更新 Word 报告，节省人工操作时间。

from docx import Documentimport pandas as pd# 假设有一个数据分析结果 DataFramedata = {    'Month': ['January', 'February', 'March'],    'Revenue': [1000, 1500, 2000]}df = pd.DataFrame(data)# 创建报告文档doc = Document()doc.add_heading('Monthly Revenue Report', level=1)# 添加表格并填充数据table = doc.add_table(rows=1, cols=len(df.columns))table.style = 'Table Grid'hdr_cells = table.rows[0].cellsfor i, column_name in enumerate(df.columns):    hdr_cells[i].text = column_namefor index, row in df.iterrows():    row_cells = table.add_row().cells    for i, value in enumerate(row):        row_cells[i].text = str(value)# 保存报告doc.save('revenue_report.docx')

批量文档处理

在文档管理中，通过 python-docx 批量处理和修改 Word 文档，如添加公司标识、统一格式等。

import osfrom docx import Document# 批量处理文档目录中的所有 Word 文档directory = 'documents'for filename in os.listdir(directory):    if filename.endswith('.docx'):        doc_path = os.path.join(directory, filename)        doc = Document(doc_path)        # 添加公司标识到页眉        header = doc.sections[0].header        header.paragraphs[0].text = 'Company Name'        # 统一文档格式        for paragraph in doc.paragraphs:            paragraph.style = 'Normal'            paragraph.alignment = WD_ALIGN_PARAGRAPH.JUSTIFY        # 保存修改后的文档        doc.save(doc_path)

动态合同生成

在合同管理中，通过 python-docx 动态生成和填写合同模板，提高工作效率和准确性。

from docx import Documentdef generate_contract(client_name, project_name, contract_date):    doc = Document('contract_template.docx')    # 填写合同信息    for paragraph in doc.paragraphs:        if '{{client_name}}' in paragraph.text:            paragraph.text = paragraph.text.replace('{{client_name}}', client_name)        if '{{project_name}}' in paragraph.text:            paragraph.text = paragraph.text.replace('{{project_name}}', project_name)        if '{{contract_date}}' in paragraph.text:            paragraph.text = paragraph.text.replace('{{contract_date}}', contract_date)    # 保存合同    doc.save(f'{client_name}_contract.docx')# 使用动态合同生成函数generate_contract('John Doe', 'Website Development', '2023-01-01')

总结

python-docx 库是一个功能强大且易于使用的工具，能够帮助开发者在各种应用场景中高效地操作和生成 Word 文档。通过支持创建和修改文档、多种格式、图像和表格操作、段落和标题设置等功能，python-docx 提供了强大的功能和灵活的扩展能力。本文详细介绍了 python-docx 库的安装方法、主要特性、基本和高级功能，以及实际应用场景。希望本文能帮助大家全面掌握 python-docx 库的使用，并在实际项目中发挥其优势。无论是在自动化报告生成、批量文档处理还是动态合同生成中，python-docx 库都将是一个得力的工具。