Puppeteer vs pdfkit：合同 PDF 生成的工程权衡

在为客户构建电子签合同系统时，我们对比了两种主流的 PDF 生成方案。

Puppeteer（headless Chrome）：HTML/CSS → PDF。保真度最高，签名图嵌入用 img 即可。代价：Docker 镜像 +200MB，需要安装 Chromium，PDF 生成耗时 1-3s。

pdfkit：纯 JS 直接画 PDF。轻量，启动快，但布局靠手工坐标。复杂表格、签名图叠加、自定义字体都很折磨。

我们的选择规则：

- 富文本合同 / 富格式报告 → Puppeteer。开发速度比性能更重要。 - 数据驱动表格 / 凭证 / 标签 → pdfkit。模板化、可复用、轻量。

Phase 2 我们的合同模块走 Puppeteer，开发周期 2 天而不是 2 周。