python-docx完全指南：如何用Python轻松创建和修改Word文档

房伟宁

743人浏览 · 2026-03-13 01:58:39

房伟宁 · 2026-03-13 01:58:39 发布

python-docx完全指南：如何用Python轻松创建和修改Word文档

【免费下载链接】python-docx Create and modify Word documents with Python 项目地址: https://gitcode.com/gh_mirrors/py/python-docx

python-docx是一个强大的Python库，让你能够轻松创建、修改和处理Word文档。无论你是需要自动生成报告、批量处理文档，还是创建复杂格式的文档，python-docx都能满足你的需求。本文将为你提供一个全面的指南，帮助你快速掌握python-docx的使用方法。

为什么选择python-docx？

在日常工作和学习中，我们经常需要处理Word文档。手动创建和修改大量文档不仅耗时耗力，还容易出错。python-docx的出现，为我们提供了一种高效、灵活的方式来处理Word文档。它允许我们使用Python代码来控制文档的各个方面，从文本内容到格式设置，再到图片和表格的插入。

python-docx的主要优势

简单易用：python-docx提供了直观的API，让你能够轻松上手。
功能强大：支持创建、修改文档的各种元素，如段落、表格、图片、页眉页脚等。
高度可定制：可以精确控制文档的格式，满足各种复杂需求。
跨平台：在Windows、Mac和Linux系统上都能正常工作。

安装python-docx

安装python-docx非常简单，只需使用pip命令即可：

pip install python-docx

如果你需要从源代码安装，可以先克隆仓库：

git clone https://gitcode.com/gh_mirrors/py/python-docx
cd python-docx
pip install .

创建第一个Word文档

让我们从创建一个简单的Word文档开始。以下是一个基本示例：

from docx import Document

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

# 添加标题
doc.add_heading('我的第一个python-docx文档', level=0)

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

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

运行这段代码后，你将得到一个名为"first_doc.docx"的Word文档，其中包含一个标题和一个段落。

文档基本结构

在深入了解python-docx的各种功能之前，让我们先了解一下Word文档的基本结构。一个典型的Word文档包含以下几个主要部分：

标题(Heading)：文档的标题，通常分为不同的级别。
段落(Paragraph)：文档的基本文本单元。
表格(Table)：用于展示结构化数据。
图片(Image)：可以插入各种格式的图片。
页眉页脚(Header/Footer)：出现在每页顶部和底部的内容。

格式化文本

python-docx允许你对文本进行各种格式化，包括字体、大小、颜色、粗体、斜体等。以下是一些常用的文本格式化示例：

from docx import Document
from docx.shared import Inches, Pt
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.shared import RGBColor

doc = Document()

# 添加标题
title = doc.add_heading('文本格式化示例', level=1)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER

# 添加段落并设置格式
para = doc.add_paragraph()
run = para.add_run('这是粗体文本')
run.bold = True

run = para.add_run('，这是斜体文本')
run.italic = True

run = para.add_run('，这是红色文本')
run.font.color.rgb = RGBColor(255, 0, 0)

run = para.add_run('，这是24号字体的文本')
run.font.size = Pt(24)

doc.save('formatted_text.docx')

插入图片

在Word文档中插入图片是常见的需求。python-docx支持插入各种格式的图片，如JPG、PNG、BMP等。以下是插入图片的示例：

from docx import Document
from docx.shared import Inches

doc = Document()

doc.add_heading('图片插入示例', level=1)
doc.add_paragraph('以下是一张风景图片：')

# 插入图片
doc.add_picture('features/steps/test_files/mountain.bmp', width=Inches(6))

doc.save('image_doc.docx')

创建表格

表格是展示结构化数据的理想方式。python-docx提供了创建和修改表格的功能。以下是一个创建表格的示例：

from docx import Document

doc = Document()

doc.add_heading('表格示例', level=1)

# 创建一个3行3列的表格
table = doc.add_table(rows=3, cols=3)

# 设置表头
hdr_cells = table.rows[0].cells
hdr_cells[0].text = '姓名'
hdr_cells[1].text = '年龄'
hdr_cells[2].text = '职业'

# 填充表格数据
data = [
    ('张三', '25', '工程师'),
    ('李四', '30', '设计师'),
    ('王五', '35', '经理')
]

for i, (name, age, job) in enumerate(data):
    row_cells = table.rows[i+1].cells
    row_cells[0].text = name
    row_cells[1].text = age
    row_cells[2].text = job

doc.save('table_doc.docx')

设置页眉页脚

页眉和页脚是文档的重要组成部分，可以包含页码、日期、公司标志等信息。以下是设置页眉页脚的示例：

from docx import Document
from docx.enum.text import WD_ALIGN_PARAGRAPH

doc = Document()

# 设置页眉
section = doc.sections[0]
header = section.header
header_para = header.paragraphs[0]
header_para.text = '这是页眉内容'
header_para.alignment = WD_ALIGN_PARAGRAPH.CENTER

# 设置页脚
footer = section.footer
footer_para = footer.paragraphs[0]
footer_para.text = '第 {PAGE} 页，共 {NUMPAGES} 页'
footer_para.alignment = WD_ALIGN_PARAGRAPH.CENTER

doc.add_heading('页眉页脚示例', level=1)
for i in range(5):
    doc.add_paragraph(f'这是第{i+1}段文本。')

doc.save('header_footer_doc.docx')