docxtemplater
本篇范围
本篇聚焦 docxtemplater（用模板填充生成 docx / pptx / xlsx）——在 Word/PowerPoint/Excel 里用占位符标签做好模板，运行时再用 render(data) 把数据填进去。重点在：「模板 + 数据 → 文档」的填充模型、必配的 PizZip 加载、{tag} 占位符 / {#loop}{/loop} 循环 / {^cond}{/cond} 条件、默认解析器的局限与 expressions（angular）解析器、异步数据 renderAsync、错误聚合 error.properties.errors、浏览器（toBlob + FileSaver）与 Node（toBuffer）差异，以及最关键的 「开放核心」免费边界——核心 MIT/GPLv3 免费，图片/HTML/图表/XLSX 等是付费模块。版本基线 3.x。
docxtemplater 的官方定位是「用模板生成 docx/pptx/xlsx 文档」——让非程序员在自己熟悉的 Office 软件里排好版、在动态处写上 {标签}，开发只负责调 render(data) 把后端 JSON 填进去。它处理的是 Office Open XML（OOXML） 文档的「模板填充」，而不是从零用代码绘制文档（那是 docx 这类编程式库的路子）。
理解 docxtemplater 的关键有三点：① docx/pptx/xlsx 本质都是 ZIP 压缩包，docxtemplater 自己不解压，必须搭配 PizZip 把模板读进内存；② 它的标签系统对所有 OOXML 通用——同一套 {tag}/{#loop}/{^cond} 语法，Word、PPT、Excel 模板都能用；③ 它是 open core（开放核心）——核心库免费（MIT/GPLv3 双许可），但图片、HTML、图表、XLSX 单元格、幻灯片、样式、脚注等约 19 个功能模块是商业付费模块。一条高频认知坑：默认解析器不支持点号嵌套属性（{user.name} 会被当成字面键名），要用点号/比较/运算/过滤器，得显式启用免费的 expressions 解析器（docxtemplater/expressions.js）。
评价
优点
- 模板与代码解耦：排版交给设计/业务人员用 Word 可视化完成，开发只填数据，分工清晰、改样式不动代码
- 标签语法直观：
{name}替换、{#list}{/list}循环、{^empty}{/empty}条件，非程序员也易上手 - 三种 Office 格式通用：docx/pptx/xlsx 共用一套标签（底层都是 OOXML zip）
- 浏览器 + Node 双端：浏览器
toBlob()+ FileSaver 下载、NodetoBuffer()写盘/作为响应返回 - 异步数据原生支持：
renderAsync(data)可直接吃 Promise（HTTP/DB 取值），无需手动预解析 - 错误信息结构化：多个模板错误聚合成 MultiError，
error.properties.errors逐条给出可读explanation - 核心免费可商用：MIT/GPLv3 双许可，可按 MIT 闭源商用
缺点
- 关键能力需付费：插图片、插 HTML、画图表、操作 xlsx 单元格、子模板等都在付费模块里，免费边界要算清
- 默认解析器很弱：不支持
{a.b}嵌套、比较、运算，必须启用 expressions 解析器（虽免费但要额外配） - 「标签被拆」经典坑：在 Word 里编辑标签时，拼写检查/格式会把一个
{tag}拆进多个 run，导致识别失败 - 依赖外部 zip 库：必须配 PizZip 才能加载模板，少装就跑不起来
- 不是编辑器/排版器：只填模板，复杂版式得先在 Office 里做好
- raw XML 受限：免费
{@rawXml}仅段落级，插不了图片等复杂元素
文档地址
GitHub 地址
open-xml-templating/docxtemplater