Python 办公实战：用 python-docx 自动生成 Word 文档
目录
引言
一、环境准备与基础操作
1.1 库安装与导入
1.2 创建空白文档
二、核心元素操作实战
2.1 标题与段落处理
2.2 表格自动化生成
2.3 图片插入与控制
三、高级格式控制技巧
3.1 段落格式深度定制
3.2 字符级样式控制
四、实战场景解析
4.1 模板填充自动化
4.2 批量文档生成
五、性能优化与最佳实践
5.1 样式复用策略
5.2 内存优化技巧
六、常见问题解决方案
结语
引言
在数字化办公场景中，Word 文档自动化生成能显著提升工作效率。本文通过实战案例，系统讲解如何利用 python-docx 库实现从基础文档创建到复杂格式控制的完整流程，涵盖标题、段落、表格、图片等核心元素的自动化处理技巧。
一、环境准备与基础操作
1.1 库安装与导入
pip install python-docx
python
from docx import Document
from docx.shared import Pt, Inches
from docx.enum.text import WD_PARAGRAPH_ALIGNMENT1.2 创建空白文档
doc = Document()二、核心元素操作实战
2.1 标题与段落处理
多级标题创建：
doc.add_heading('一级标题', level=1)
doc.add_heading('二级标题', level=2)格式化段落：
p = doc.add_paragraph('设置格式的段落')
run = p.runs[0]
run.bold = True
run.font.size = Pt(14)
p.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER2.2 表格自动化生成
动态表格创建：
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().cellsrow_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 段落格式深度定制
缩进与间距设置：
p.paragraph_format.left_indent = Inches(0.5)
p.paragraph_format.right_indent = Pt(24)
p.paragraph_format.space_after = Pt(12)制表位应用：
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 字符级样式控制
字体效果组合：
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 模板填充自动化
合同文档生成：
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驱动生成：
import pandas as pddf = 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 样式复用策略
全局样式定义：
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 内存优化技巧
流式处理大文档：
doc = Document()
for i in range(1000):doc.add_paragraph(f'第{i}条记录')if i % 50 == 0:doc.add_page_break()六、常见问题解决方案
6.1 中文字体显示问题
from docx.oxml.ns import qn
run._element.rPr.rFonts.set(qn('w:eastAsia'), '宋体')6.2 表格自动调整
table.autofit = False
table.columns[0].width = Inches(1.5)结语
通过系统掌握python-docx的层级结构控制和样式管理，可实现从简单报告到复杂模板的自动化生成。实际应用中需注意文档结构规划、样式预定义和异常处理机制，这些实践能显著提升自动化文档的可靠性和可维护性。