python-docx,一个 Word 文档操作的 Python 库!

.docx

文件，是办公自动化的必备工具。在实际生活中，它的价值无处不在：

• 职场办公：批量生成劳动合同、周报、月报、请假单，一键替换模板关键词；
• 文案创作：自动排版文章、设置字体段落、添加标题列表，统一文档格式；
• 数据报表：将 Excel / 数据库数据自动生成 Word 分析报告，无需手动复制粘贴；
• 资料整理：批量读取 Word 文档内容、提取文字、修改段落，高效处理文档资料。

它操作简单、功能强大，支持自定义字体、颜色、段落、表格、图片等所有 Word 核心元素，让代码替代人工，实现 10 分钟完成几小时的文档处理工作。

二、安装库

python-docx 是第三方库，需要通过 pip 命令快速安装，打开命令提示符执行：

pip install python-docx

安装完成后，直接导入库即可使用，无复杂环境配置，新手也能快速上手。

三、基本用法（分 4 步快速上手）

1. 创建文档对象

初始化空白 Word 文档，这是所有操作的基础：

# 导入核心类 from docx import Document # 创建空白文档对象 doc = Document()

2. 添加标题与段落

快速添加文档标题和正文，支持多级标题：

# 添加一级标题 doc.add_heading('办公自动化实战', level=1) # 添加正文段落 p = doc.add_paragraph('python-docx是Python处理Word的最佳工具，轻松实现批量文档处理。')

4. 读取现有文档

打开已有的 Word 文档，读取文字内容：

# 打开现有文档 doc = Document('测试文档.docx') # 遍历读取所有段落 for paragraph in doc.paragraphs:     print(paragraph.text)

四、高级用法

进阶功能满足专业办公需求，实现精细化文档处理：

1. 1.设置文字格式
   1. ：自定义字体、大小、加粗、颜色
   from docx.shared import Pt from docx.oxml.ns import qn  run = p.runs[0] # 设置字体大小 run.font.size = Pt(14) # 设置加粗 run.bold = True # 设置中文字体 run.font.name = '微软雅黑' run._element.rPr.rFonts.set(qn('w:eastAsia'), '微软雅黑')

   2.插入表格
   ：自动创建表格并填充数据

# 创建3行2列的表格 table = doc.add_table(rows=3, cols=2, style='Table Grid') # 填充表格数据 table.cell(0, 0).text = '姓名' table.cell(0, 1).text = '职位' table.cell(1, 0).text = '张三' table.cell(1, 1).text = 'Python工程师'

# 定义替换规则 replace_dict = {'{{公司}}': '科技有限公司', '{{日期}}': '2025年12月29日'} # 遍历段落替换 for p in doc.paragraphs:     for old, new in replace_dict.items():         if old in p.text:             p.text = p.text.replace(old, new)

# 添加无序列表 doc.add_paragraph('1. 安装库', style='List Bullet') # 添加分页符 doc.add_page_break()

from docx import Document  # 员工数据 employees = [     {'name': '李四', 'id': '001', 'department': '技术部', 'salary': '15000'},     {'name': '王五', 'id': '002', 'department': '产品部', 'salary': '12000'} ]  # 批量生成合同 for emp in employees:     doc = Document('合同模板.docx')     # 替换模板变量     for p in doc.paragraphs:         p.text = p.text.replace('{{姓名}}', emp['name'])         p.text = p.text.replace('{{工号}}', emp['id'])         p.text = p.text.replace('{{部门}}', emp['department'])         p.text = p.text.replace('{{薪资}}', emp['salary'])     # 保存合同     doc.save(f'{emp["name"]}入职合同.docx')

from docx import Document from docx.shared import Pt  doc = Document() # 标题 doc.add_heading('月度销售数据分析报告', 0) # 正文 doc.add_paragraph('一、核心数据：本月总销售额120万元，同比增长20%。') # 数据表格 table = doc.add_table(rows=4, cols=2) headers = ['产品', '销售额'] data = [['手机', '60万'], ['电脑', '40万'], ['配件', '20万']] for i, (h1, h2) in enumerate([headers] + data):     table.cell(i, 0).text = h1     table.cell(i, 1).text = h2 doc.save('销售报告.docx')