用 Python 写了个小工具：让 Excel 数据自动填充 Word 模板
用 Python 写了个小工具：让 Excel 数据自动填充 Word 模板
最近被重复性的文档填写工作搞烦了。
每次要给客户发合同、证书、通知书之类的文件，内容差不多，就是名字、日期、金额不一样。手改吧，10份以内还能忍；100份就开始心态爆炸了。
所以写了个小工具，专门干这件事：Excel 数据 + Word 模板 = 一键批量生成 Word 文档。
痛点场景
你有没有遇到过这种情况：
- 100 份录取通知书，就名字不一样
- 50 份合同，金额、日期不同
- 节日给客户发批量邮件，附件要是个性化 PDF
手改改到怀疑人生，复制粘贴改名字改到吐。
我之前也是这么干的。直到某天忍无可忍，决定写个工具解放自己。
解决方案
思路很简单：
- Excel 放数据，每行一条记录
- Word 模板里用
{{字段名}}占位 - 程序自动替换，生成 N 个文件
Word 模板示例：
您好，{{姓名}}！ 您的订单 {{订单号}} 已确认， 将于 {{日期}} 送达 {{地址}}。Excel 表头对应：
| 姓名 | 订单号 | 日期 | 地址 |
|---|---|---|---|
| 张三 | A001 | 2026-04-01 | 北京市朝阳区 |
运行之后，自动生成张三.docx，内容里所有{{姓名}}都替换成"张三"。
核心代码
用到的库就两个：openpyxl读 Excel，python-docx操作 Word。
占位符替换逻辑
defreplace_placeholders(doc,data_dict):"""替换 Word 里的 {{字段名}}"""replaced_count=0# 段落 + 表格都要处理forparagraphindoc.paragraphs:forruninparagraph.runs:if'{{'inrun.textand'}}'inrun.text:forkey,valueindata_dict.items():placeholder='{{'+key+'}}'ifplaceholderinrun.text:run.text=run.text.replace(placeholder,str(value))replaced_count+=1# 表格里的占位符也要替换fortableindoc.tables:forrowintable.rows:forcellinrow.cells:forparagraphincell.paragraphs:forruninparagraph.runs:if'{{'inrun.textand'}}'inrun.text:forkey,valueindata_dict.items():placeholder='{{'+key+'}}'ifplaceholderinrun.text:run.text=run.text.replace(placeholder,str(value))replaced_count+=1returnreplaced_count批量生成
forrow_numinrange(2,ws.max_row+1):# 读取 Excel 行数据data=read_excel_row(ws,row_num)# 加载模板new_doc=Document(template_path)# 替换占位符replace_placeholders(new_doc,data)# 生成文件名（优先用姓名/标题）filename=generate_filename(data,row_num)# 保存new_doc.save(os.path.join(output_folder,filename))使用方式
命令行
python excel-to-word-template.py data.xlsx template.docx output/交互模式
不加参数直接运行，会弹出文件选择对话框：
python excel-to-word-template.py这个功能依赖 tkinter，如果没装会降级成手动输入路径。算是兜底方案吧。
踩过的坑
坑1：日期格式乱了
Excel 里的日期类型，直接读出来是个数字（比如45456）。处理方式是判断是否有strftime方法，有就转换：
ifhasattr(value,'strftime'):value=value.strftime('%Y-%m-%d')坑2：文件名冲突
如果两条数据姓名一样，后面的会覆盖前面的。加了个自动编号：
ifos.path.exists(output_path):name,ext=os.path.splitext(filename)counter=1whileos.path.exists(output_path):output_path=os.path.join(output_folder,f"{name}_{counter}{ext}")counter+=1坑3：字段名对不上
模板里写了{{姓名}}，Excel 表头是{{用户名称}}，结果生成的文件全是占位符。所以加了匹配检查：
matched_fields=[fforfintemplate_fieldsiffinheaders]print(f"✅ 字段匹配:{len(matched_fields)}/{len(template_fields)}")不匹配会警告，但不会中断执行——毕竟有些模板字段可能就是用来放空的。
效果展示
处理 100 份文件，大概 3-5 秒（主要看 Word 模板复不复杂）。
🚀 开始生成 Word 文件... ✅ [1/100] 张三.docx ✅ [2/100] 李四.docx ✅ [3/100] 王五.docx ... 🎉 完成！成功生成 100 个 Word 文件 📁 输出目录: output写在最后
这个小工具没什么高大上的技术，就是解决实际问题。
如果你也被重复性文档工作困扰，不妨试试。代码开源在 GitHub，拿去随便用。
项目地址：
https://github.com/Remy0328/excel-to-word-generator
依赖：
pipinstallopenpyxl python-docx有改进建议欢迎评论区交流。