DOCX 模板导出工具

什么是 DOCX 模板导出？

DOCX 模板导出是一个基于 docxtemplater 的文档生成工具，它允许用户使用预先设计好的 Word 模板，结合 Excel 或 CSV 数据源，批量生成个性化的 Word 文档。

核心价值

1. 批量生成：一次操作生成多份个性化文档
2. 模板复用：设计一次模板，永久使用
3. 格式保真：保留 Word 原生格式、样式和布局
4. 简单易用：无需编程知识即可上手

典型应用场景

• 合同生成：批量生成采购合同、服务协议
• 证书打印：员工证书、获奖证书、结业证书
• 报告输出：数据分析报告、财务报表
• 信函合并：邀请函、通知函、感谢信
• 名片制作：批量生成个性化名片

技术基础

本工具使用 docxtemplater 作为核心渲染引擎，这是目前最成熟的 JavaScript 文档模板库之一，支持：

• 变量替换
• 循环遍历
• 条件判断
• 图片插入
• 表格处理

使用方法

快速开始

第一步：下载数据模板

1. 点击「下载模板」按钮
2. 选择 CSV 或 Excel 格式
3. 用 Excel 或文本编辑器打开下载的模板文件

第二步：填写数据

在模板文件中填写你的数据：

• 第一行：字段名（英文，用于 Word 模板占位符）
• 后续行：实际数据

示例：

第三步：准备 Word 模板

1. 新建 Word 文档
2. 设计你想要的文档格式和样式
3. 在需要填入数据的位置添加占位符

第四步：上传文件

1. 上传填写好的数据文件（CSV 或 Excel）
2. 上传设计好的 Word 模板

第五步：渲染并下载

1. 点击「渲染」按钮
2. 等待处理完成
3. 点击「下载结果」获取生成的文档

模板语法

基本变量

{{name}}      // 替换为 name 字段的值
{{age}}       // 替换为 age 字段的值

循环语法

用于遍历数组数据（如表格行）：

{#items}
姓名：{{name}}
年龄：{{age}}
{/items}

条件判断

根据数据条件显示不同内容：

{?showVip}
尊敬的VIP会员：{{name}}
{/?showVip}

注意事项

1. 字段名只能使用英文字母、数字和下划线
2. 字段名区分大小写：{{name}} 和 {{Name}} 是不同的
3. 循环语法 { 和 } 之间不要有空格
4. 建议先测试单条数据，再批量生成

技术说明

技术栈

工作原理

用户数据 (CSV/Excel)
       ↓
  数据解析层 (papaparse / xlsx)
       ↓
  JSON 数据对象
       ↓
  模板渲染层 (docxtemplater)
       ↓
  DOCX 文件生成 (pizzip)
       ↓
  文件下载 (file-saver)

docxtemplater 核心概念

标签类型

1. 替换标签：{{field}} → 替换为对应字段值
2. 循环标签：{#array}{item}{/array} → 遍历数组
3. 条件标签：{?condition}content{/?condition} → 条件渲染
4. raw 标签：{@rawHtml} → 原始 HTML 内容（需启用模块）

渲染流程

// 1. 加载 DOCX 文件（本质是 ZIP）
const zip = new PizZip(templateContent)

// 2. 创建渲染实例
const doc = new Docxtemplater(zip)

// 3. 设置数据
doc.render({
  name: '张三',
  items: [{ name: '项目A', value: 100 }]
})

// 4. 生成文件
const blob = doc.getZip().generate({
  type: 'blob',
  mimeType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
})

浏览器兼容性

• 现代浏览器（Chrome、Firefox、Edge、Safari）
• 不支持 IE 浏览器

文件大小限制

• 数据文件：建议不超过 10MB
• 模板文件：建议不超过 5MB

已知限制

1. 单文档模式：当前版本每次生成一份文档（使用第一条数据）
2. 不支持图片占位符：需要额外配置图片模块
3. 不支持复杂表格合并单元格：需使用 docxtemplater 表格模块