Python 办公实战:用 python-docx 自动生成 Word 文档

引言

在数字化办公场景中,Word 文档自动化生成能显著提升工作效率。本文通过实战案例,系统讲解如何利用 python-docx 库实现从基础文档创建到复杂格式控制的完整流程,涵盖标题、段落、表格、图片等核心元素的自动化处理技巧。

一、环境准备与基础操作

1.1 库安装与导入

javascript 复制代码
pip install python-docx
python
from docx import Document
from docx.shared import Pt, Inches
from docx.enum.text import WD_PARAGRAPH_ALIGNMENT

1.2 创建空白文档

ini 复制代码
doc = Document()

二、核心元素操作实战

2.1 标题与段落处理

多级标题创建:

ini 复制代码
doc.add_heading('一级标题', level=1)
doc.add_heading('二级标题', level=2)

格式化段落:

ini 复制代码
p = doc.add_paragraph('设置格式的段落')
run = p.runs[0]
run.bold = True
run.font.size = Pt(14)
p.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER

2.2 表格自动化生成

动态表格创建:

ini 复制代码
table = doc.add_table(rows=1, cols=3)
table.style = 'Table Grid'
hdr_cells = table.rows[0].cells
hdr_cells[0].text = '姓名'
hdr_cells[1].text = '部门'
hdr_cells[2].text = '工资'
 
data = [("张三", "财务部", "8000"), ("李四", "人事部", "7500")]
for item in data:
    row_cells = table.add_row().cells
    row_cells[0].text = item[0]
    row_cells[1].text = item[1]
    row_cells[2].text = item[2]

2.3 图片插入与控制

精准尺寸控制:

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

三、高级格式控制技巧

3.1 段落格式深度定制

缩进与间距设置:

ini 复制代码
p.paragraph_format.left_indent = Inches(0.5)
p.paragraph_format.right_indent = Pt(24)
p.paragraph_format.space_after = Pt(12)

制表位应用:

ini 复制代码
tab_stops = p.paragraph_format.tab_stops
tab_stop = tab_stops.add_tab_stop(Inches(1.5), WD_TAB_ALIGNMENT.RIGHT, WD_TAB_LEADER.DOTS)

3.2 字符级样式控制

字体效果组合:

ini 复制代码
run = p.add_run('高级格式示例')
run.font.name = '微软雅黑'
run.font.size = Pt(16)
run.font.color.rgb = RGBColor(0x00, 0x66, 0xcc)
run.font.underline = WD_UNDERLINE.DOUBLE

四、实战场景解析

4.1 模板填充自动化

合同文档生成:

scss 复制代码
def fill_template(template_path, output_path, context):
    doc = Document(template_path)
    for para in doc.paragraphs:
        for key, val in context.items():
            if f'{{{{{key}}}}}' in para.text:
                para.text = para.text.replace(f'{{{{{key}}}}}', str(val))
    doc.save(output_path)
 
context = {
    "contract_no": "HT2024060101",
    "party_a": "上海科技有限公司",
    "amount": 35000
}
fill_template("contract_template.docx", "output.docx", context)

4.2 批量文档生成

Excel驱动生成:

python 复制代码
import pandas as pd
 
df = pd.read_excel('employees.xlsx')
for index, row in df.iterrows():
    doc = Document()
    doc.add_heading(f'员工档案-{row["编号"]}', level=1)
    doc.add_paragraph(f'姓名:{row["姓名"]}')
    doc.add_paragraph(f'部门:{row["部门"]}')
    doc.save(f'archives/{row["编号"]}.docx')

五、性能优化与最佳实践

5.1 样式复用策略

全局样式定义:

ini 复制代码
styles = doc.styles
title_style = styles.add_style('CustomTitle', WD_STYLE_TYPE.PARAGRAPH)
title_font = title_style.font
title_font.name = '微软雅黑'
title_font.size = Pt(22)

5.2 内存优化技巧

流式处理大文档:

scss 复制代码
doc = Document()
for i in range(1000):
    doc.add_paragraph(f'第{i}条记录')
    if i % 50 == 0:
        doc.add_page_break()

六、常见问题解决方案

6.1 中文字体显示问题

python 复制代码
from docx.oxml.ns import qn
run._element.rPr.rFonts.set(qn('w:eastAsia'), '宋体')

6.2 表格自动调整

ini 复制代码
table.autofit = False
table.columns[0].width = Inches(1.5)

结语

通过系统掌握python-docx的层级结构控制和样式管理,可实现从简单报告到复杂模板的自动化生成。实际应用中需注意文档结构规划、样式预定义和异常处理机制,这些实践能显著提升自动化文档的可靠性和可维护性。

相关推荐
博观而约取36 分钟前
Django ORM 1. 创建模型(Model)
数据库·python·django
精灵vector2 小时前
构建专家级SQL Agent交互
python·aigc·ai编程
Zonda要好好学习2 小时前
Python入门Day2
开发语言·python
Vertira2 小时前
pdf 合并 python实现(已解决)
前端·python·pdf
太凉2 小时前
Python之 sorted() 函数的基本语法
python
项目題供诗3 小时前
黑马python(二十四)
开发语言·python
晓13133 小时前
OpenCV篇——项目(二)OCR文档扫描
人工智能·python·opencv·pycharm·ocr
是小王同学啊~3 小时前
(LangChain)RAG系统链路向量检索器之Retrievers(五)
python·算法·langchain
AIGC包拥它3 小时前
提示技术系列——链式提示
人工智能·python·langchain·prompt
孟陬3 小时前
Python matplotlib 如何**同时**展示正文和 emoji
python