Python操作Word教程：python-docx使用指南

想要用Python轻松操作Word文档吗？这篇**Python操作Word文档教程：python-docx入门指南**将带你快速上手`python-docx`库，实现Word文档的自动化处理。无论是创建新文档、添加段落标题，还是设置文字样式、插入表格图片，甚至是批量处理已有文档，`python-docx`都能帮你轻松搞定。本文将从创建文档、样式设置、表格图片插入以及批量文本替换等多个实用场景入手，详细讲解`python-docx`的使用方法。即使是日常办公中常见的自动化报告生成、批量文档处理等任务，也能通过Python高效完成。告别繁琐的手动操作，让Python成为你的效率利器！虽然`python-docx`在页眉页脚等高级功能上有所欠缺，但对于大多数日常需求来说，已经足够强大且易于上手。

使用python-docx可实现Python操作Word文档，适合自动化报告生成和批量处理任务。1. 创建新文档并添加内容：通过Document()新建文档，add_paragraph和add_heading添加段落和标题，最后用save保存；2. 设置文字样式和格式：使用add_run控制段落中不同样式，设置bold、font.color.rgb（需导入RGBColor）和font.size（单位Pt）等属性；3. 插入表格和图片：add_table创建表格并通过cell填充内容，设置style美化表格，add_picture插入图片（需导入Inches定义尺寸）；4. 批量处理已有文档：加载文档后遍历paragraphs读取或替换文本，保存为新文件。虽然不支持页眉页脚等高级功能，但能满足多数日常需求。

Python操作Word文档其实挺方便的，尤其是用python-docx这个库，可以轻松实现读写.docx格式的文档。它支持添加文字、表格、图片、样式设置等常见功能，适合用来做自动化报告生成、批量处理文档这类任务。

下面我会从几个常用场景出发，讲讲怎么用python-docx来操作Word文档。

创建一个新文档并添加内容

新建文档是最基础的操作，你可以理解为在代码里打开一个空白Word文件，然后往里面加内容。

from docx import Document

doc = Document()
doc.add_paragraph('这是第一段文字')
doc.add_heading('这是一个标题', level=1)
doc.save('test.docx')

上面这段代码就创建了一个新文档，加了一段普通文本和一个一级标题，最后保存成test.docx。

建议：

• 每次添加内容后记得调用.save()保存。
• 如果你需要重复使用某些结构（比如固定模板），可以先加载已有文件再修改：

  doc = Document('template.docx')

给文字加样式和格式

光有文字还不够，很多时候需要加粗、斜体、改变字体大小或颜色。

paragraph = doc.add_paragraph('这是一段 ')
run = paragraph.add_run('加粗+红色')
run.bold = True
run.font.color.rgb = RGBColor(255, 0, 0)

这样你就可以控制每一段中不同部分的样式了。

注意点：

• add_run()是关键方法，它可以让你在同一段落里设置不同的样式。
• 颜色需要用RGBColor类，记得导入：

  from docx.shared import RGBColor

• 字号设置要用font.size，单位是Pt，例如：

  run.font.size = Pt(14)

插入表格和图片

除了文字，表格和图片也是Word文档里的常见元素。

添加表格：

table = doc.add_table(rows=2, cols=3)
table.cell(0, 0).text = '第一行第一列'
table.cell(1, 2).text = '第二行第三列'

表格默认没有边框，如果想好看一点，可以设置样式：

table.style = 'Table Grid'

插入图片：

doc.add_picture('logo.png', width=Inches(1.5))

记得导入单位模块：

from docx.shared import Inches

小技巧：

• 表格内容多的时候，可以用循环填充数据，比如从Excel读取后自动填到Word表格里。
• 图片插入时尽量统一尺寸，避免排版混乱。

批量处理已有文档内容

如果你不是新建文档，而是要读取或修改已有的Word文件，也可以用python-docx来做。

doc = Document('existing.docx')
for para in doc.paragraphs:
    print(para.text)

这段代码会把文档中所有段落的内容打印出来。

如果你想替换某些关键词，可以这样做：

for para in doc.paragraphs:
    if '旧内容' in para.text:
        para.text = para.text.replace('旧内容', '新内容')
doc.save('updated.docx')

注意：

• 这种方式只能替换完整段落中的文本，不能精确到某一个run。
• 如果文档结构复杂，建议结合xml解析或者考虑其他库（比如zipfile解包处理）。

总的来说，python-docx已经能满足大多数日常需求了。虽然有些高级功能不支持（比如页眉页脚、图表等），但对于自动化写文档、批量处理来说已经很够用了。

基本上就这些，照着例子试试，应该很快就能上手。

本篇关于《Python操作Word教程：python-docx使用指南》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！