使用 Python-docx 进行 Word 文档操作

使用 Python-docx 进行 Word 文档操作

1. 什么是 Python-docx?

python-docx 是一个用于创建、修改 Microsoft Word 文件的 Python 库。通过使用这个库,用户可以自动化地生成、编辑 .docx 格式的文档。这在报告生成、批量文档处理等场景中非常有用。python-docx模块提供了一个强大的接口来创建和修改Word文档。

2. 安装 Python-docx

首先,你需要安装 python-docx。可以使用以下命令进行安装:

bash 复制代码
pip install python-docx

3. 创建 Word 文档

创建 Word 文档是 python-docx 的一个基本功能。你可以通过简单的代码生成一个 .docx 文件,并向其中添加段落、标题和其他内容。

示例代码
python 复制代码
from docx import Document

# 创建一个新的文档对象
doc = Document()

# 添加标题
doc.add_heading('Python-docx 使用示例', level=1)

# 添加段落
doc.add_paragraph('这是使用 Python-docx 库创建的第一个段落。')

# 保存文档
doc.save('demo.docx')
代码说明
  • Document():创建一个新的文档对象。
  • add_heading() :向文档中添加标题。level=1 表示标题级别为 1,对应 Word 文档中的一级标题。
  • add_paragraph():向文档中添加普通段落。
  • save():将文档保存为指定的文件名。

运行上述代码后,会生成一个名为 demo.docx 的 Word 文档,内容包括一级标题和一个段落。

4. 向文档中添加内容

python-docx 可以向文档中添加多种内容,如段落、标题、图片、表格等。以下是一些常见的操作示例。

4.1 添加标题

可以通过 add_heading() 方法向文档中添加不同级别的标题,最高支持 1 到 9 级标题。

python 复制代码
doc.add_heading('这是一级标题', level=1)
doc.add_heading('这是二级标题', level=2)
4.2 添加段落

段落可以通过 add_paragraph() 方法添加。可以选择在段落中设置文字的格式,如加粗、斜体等。

python 复制代码
# 添加普通段落
paragraph = doc.add_paragraph('这是一个普通段落。')

# 添加带格式的段落
paragraph = doc.add_paragraph()
run = paragraph.add_run('这是一个带有加粗和斜体的段落。')
run.bold = True  # 加粗
run.italic = True  # 斜体
4.3 添加图片

使用 add_picture() 可以将图片插入文档,并可以指定图片的大小。

python 复制代码
doc.add_picture('image.jpg', width=docx.shared.Inches(1.0))
4.4 添加表格

python-docx 也可以向文档中添加表格,并通过遍历操作向表格中插入数据。

python 复制代码
# 添加一个 2x2 的表格
table = doc.add_table(rows=2, cols=2)

# 向表格中添加数据
table.cell(0, 0).text = '行1, 列1'
table.cell(0, 1).text = '行1, 列2'
table.cell(1, 0).text = '行2, 列1'
table.cell(1, 1).text = '行2, 列2'

5. 修改现有 Word 文档

python-docx 中,除了创建新的文档,还可以打开并修改现有的 Word 文档。

示例代码
python 复制代码
from docx import Document

# 打开现有文档
doc = Document('existing_document.docx')

# 向文档中添加新段落
doc.add_paragraph('这是添加到现有文档的新段落。')

# 保存修改后的文档
doc.save('modified_document.docx')
代码说明
  • Document('existing_document.docx'):打开一个现有的 Word 文档。
  • add_paragraph():在现有文档的末尾添加新段落。
  • save():将修改后的文档保存为新的文件。

6. 设置文档格式

你可以通过 python-docx 对文档的样式进行设置,例如设置字体、段落对齐方式、行距等。

6.1 设置字体

通过修改 run 对象的属性可以设置字体、大小、颜色等。

python 复制代码
from docx.shared import Pt

paragraph = doc.add_paragraph('设置字体样式的段落。')
run = paragraph.add_run('这是加粗且字体大小为 24 的文本。')
run.bold = True
run.font.size = Pt(24)
6.2 设置段落对齐

可以通过 alignment 属性来设置段落的对齐方式。

python 复制代码
from docx.enum.text import WD_ALIGN_PARAGRAPH

# 添加段落并设置居中对齐
paragraph = doc.add_paragraph('这是一个居中的段落。')
paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER

7. 代码示例:综合实例

以下是一个完整的综合实例,展示了如何使用 python-docx 创建一个包含标题、段落、图片和表格的文档。

python 复制代码
from docx import Document
from docx.shared import Inches

# 创建文档对象
doc = Document()

# 添加标题
doc.add_heading('Python-docx 综合实例', 0)

# 添加段落
doc.add_paragraph('这是一个使用 Python-docx 创建的示例文档。')

# 添加图片
doc.add_picture('image.jpg', width=Inches(1.25))

# 添加表格
table = doc.add_table(rows=3, cols=3)
table.style = 'Table Grid'

for i in range(3):
    for j in range(3):
        table.cell(i, j).text = f'行 {i+1}, 列 {j+1}'

# 保存文档
doc.save('comprehensive_demo.docx')

8. 结论

python-docx 是一个强大且易于使用的库,能够帮助开发者快速地创建和修改 .docx 格式的 Word 文档。它特别适合自动化文档生成、报告制作等场景。通过使用简单的 API 接口,开发者可以轻松操作文档中的段落、表格、图片等内容,极大提高了文档处理的效率。

python-docx 虽然功能强大,但在处理复杂文档格式(如高级表格样式、页面布局)时可能会有所限制。在更复杂的场景下,可能需要借助其他工具进行配合使用。

相关推荐
丕羽1 小时前
【Pytorch】基本语法
人工智能·pytorch·python
bryant_meng2 小时前
【python】Distribution
开发语言·python·分布函数·常用分布
m0_594526303 小时前
Python批量合并多个PDF
java·python·pdf
工业互联网专业3 小时前
Python毕业设计选题:基于Hadoop的租房数据分析系统的设计与实现
vue.js·hadoop·python·flask·毕业设计·源码·课程设计
钱钱钱端3 小时前
【压力测试】如何确定系统最大并发用户数?
自动化测试·软件测试·python·职场和发展·压力测试·postman
慕卿扬3 小时前
基于python的机器学习(二)—— 使用Scikit-learn库
笔记·python·学习·机器学习·scikit-learn
Json____3 小时前
python的安装环境Miniconda(Conda 命令管理依赖配置)
开发语言·python·conda·miniconda
小袁在上班4 小时前
Python 单元测试中的 Mocking 与 Stubbing:提高测试效率的关键技术
python·单元测试·log4j
白狐欧莱雅4 小时前
使用python中的pygame简单实现飞机大战游戏
经验分享·python·游戏·pygame
阿_旭4 小时前
基于YOLO11/v10/v8/v5深度学习的维修工具检测识别系统设计与实现【python源码+Pyqt5界面+数据集+训练代码】
人工智能·python·深度学习·qt·ai