手把手教你用Python实现自定义档案模板生成系统
前言
在企业的日常运营中，员工档案、合同、证件制作等需求通常需要将结构化数据填充到固定格式的文档中。市面上通用的OA系统往往难以满足灵活多变的排版需求。本文将提供一套完全开源、零成本的解决方案，利用Python的docxtpl库，基于Word模板实现高度自定义的档案批量生成。读者只需具备基础的计算机操作能力，即可按照本文步骤搭建一套专属的档案生成工具。
一、环境准备与依赖安装
本方案基于Python开发，首先需要配置运行环境。请严格按照以下步骤操作，确保环境一致性。
1. 安装Python环境
如果电脑中尚未安装Python，请访问Python官方发布页下载安装包。不要使用第三方打包版本，以免依赖库缺失。
下载地址： https://www.python.org/downloads/
下载对应操作系统的安装包（推荐Python 3.9及以上版本）。运行安装程序时，务必勾选底部的 "Add Python to PATH" 选项，这将允许我们在命令行中直接调用Python。安装模式选择 "Install Now" 即可。
2. 安装核心依赖库
打开终端（Windows下按Win+R，输入cmd回车），依次执行以下命令安装所需的第三方库。我们需要python-docx-template（用于处理Word模板）和Pillow（用于处理图片）。
在命令行中输入：
```bash pip install docxtpl pip install Pillow ```如果下载速度较慢，建议使用国内镜像源：
```bash pip install docxtpl -i https://pypi.tuna.tsinghua.edu.cn/simple pip install Pillow -i https://pypi.tuna.tsinghua.edu.cn/simple ```出现 "Successfully installed..." 提示即表示安装成功。
二、设计Word模板文件
这是本方案最核心的环节。我们使用Microsoft Word（或WPS）作为可视化设计器，通过特定的Jinja2语法标记动态内容区域。新建一个Word文档，命名为template.docx，保存在项目根目录下。
1. 基础文本变量替换
在文档中需要填充姓名、工号等单行文本的位置，使用双大括号标记变量名。例如：
- 姓名：
{{ name }} - 部门：
{{ department }} - 入职日期：
{{ hire_date }}
在Word中直接输入上述字符即可，无需特殊字体。
2. 动态表格数据填充
档案中通常包含“工作经历”或“家庭成员”等列表数据。在Word中插入一个表格，保留表头（如“时间段”、“职位”、“描述”），在第二行开始使用循环语法。
在表格的第一行数据单元格中输入：
```jinja {% for item in work_history %} ```在表格的最后一行数据单元格中输入：
```jinja {% endfor %} ``>中间的单元格使用{{ item.字段名 }}引用数据。例如，在“职位”列的单元格内输入{{ item.role }}。注意：for和endfor语句必须分别位于表格行首尾独立的行中，不要合并单元格。
3. 图片动态插入
若需插入员工照片，需使用docxtpl提供的特定标签。在需要插入照片的位置输入：
这里的width和height用于控制图片尺寸，单位支持cm、mm、inches等。
4. 条件渲染逻辑
如果某些内容需要根据条件显示，例如“是否在职”。可以使用条件判断语法：
```jinja {% if status == '在职' %}当前状态：正式员工
{% else %}当前状态：已离职
{% endif %} ```三、准备数据源
数据通常存储在Excel或数据库中，为了演示方便，我们构建一个Python字典结构来模拟数据。在后续开发中，你可以使用pandas库读取Excel替换此处的数据源。
新建一个文本文件，或者直接在后续的脚本中准备如下数据结构：
```python context = { "name": "张三", "department": "研发部", "hire_date": "2023-01-15", "status": "在职", 图片路径，必须是绝对路径或相对于脚本文件的正确路径 "user_photo": "photo.jpg", 表格数据列表 "work_history": [ {"role": "初级工程师", "desc": "负责后端接口开发"}, {"role": "高级工程师", "desc": "负责系统架构设计"} ] } ``>四、编写自动化生成脚本
在项目目录下创建generate.py文件。该脚本将加载模板、注入数据并输出最终文档。以下是完整的代码实现，包含图片处理逻辑，可直接复制使用。
五、运行与验证
确保项目目录下包含以下三个文件：
- template.docx：制作好的Word模板。
- photo.jpg：一张测试用的图片（若无图片，脚本会报错，可将代码中
user_photo相关逻辑注释掉）。 - generate.py：上述Python脚本。
在命令行中进入项目目录，执行：
```bash python generate.py ``>执行完毕后，目录下会新增李四_档案.docx文件。打开该文件，检查：
- 姓名、部门是否已替换为“李四”、“市场部”。
- 工作经历表格是否包含两行数据。
- 照片是否已正确插入并调整了尺寸。
六、批量处理扩展
实际场景中通常需要批量生成。只需将上述脚本中的数据部分改为循环读取Excel即可。假设安装了openpyxl（命令：pip install openpyxl），以下是批量处理的核心逻辑代码片段：
七、常见问题排查
1. 报错：KeyError: 'xxx'
这表示Word模板中使用了{{ xxx }}变量，但在Python的context字典中没有提供该键值。请检查模板中的变量名是否与代码中的Key完全一致（区分大小写）。
2. 表格生成后多了一行空行
这是Word表格的特性。确保{% for %}写在表格行的最左侧单元格，且{% endfor %}写在最右侧单元格或单独的一行。尝试将{% endfor %}放在表格外部的段落中，或调整其在表格行中的位置。
3. 图片无法显示
请检查图片路径是否正确。如果使用相对路径，请确保是基于当前工作目录（脚本运行目录）的路径。建议使用os.path.abspath获取绝对路径。图片格式建议使用jpg或png，避免使用webp等Word不原生支持的格式。
相关文章
