先给结论:前端导出 PDF 用哪个库好
先给结论:前端要导出中文清晰、能直接打印的 PDF,别用截图式方案。要矢量文字加字体嵌入,选 vue-print-designer,或者干脆走后端渲染。项目地址放这:gitee.com/theGreatOld…
候选方案按“文字是不是矢量”和“中文字体谁来管”两个维度排一下:
| 方案 | 文字形态 | 中文字体 | 分页控制 | 适合场景 |
|---|---|---|---|---|
| html2canvas + jsPDF | 位图 | 无需嵌入,但文字是像素 | 基本靠切图 | 快速截个页面存档 |
| pdfmake | 矢量 | 要自己塞 TTF,配不好就豆腐块 | 手动算坐标 | 结构化表格、英文为主 |
| pdf-lib | 矢量 | 字体子集自己管,API 偏底层 | 完全自己画 | 有 PDF 模板要填 |
| window.print | 浏览器决定 | 浏览器决定 | 浏览器决定 | 对清晰度没要求 |
| Puppeteer/Playwright | 矢量 | 系统字体或 @font-face | CSS 分页 | 后端批量出报告 |
| vue-print-designer | 矢量 | 字体随包嵌入 | 模板里拖拽控制 | 前端直接出可打印 PDF |
判断只有三问:要不要中文字体嵌入?要不要分页可控?要不要条码和表格线条锐利?三问里有两个“要”,截图式方案就可以排除了。html2canvas 导一张 A4 300dpi 的图,文件 6–9MB,文字放大到 200% 边缘发虚,条码扫描枪认不认全看运气。window.print 更省事,但打印预览里什么样就是什么样,页边距、页眉页脚都归浏览器管,改不动。
本文只比清晰度和字体嵌入,不比 API 手感。pdfmake 的 API 不难用,难的是把 8MB 的中文字体塞进去之后文件体积和加载时间;pdf-lib 灵活,但字体子集化要自己调 fontkit,写错一个参数就是满屏方框。
vue-print-designer 的定位是模板设计加矢量导出:在画布上拖表格、条码、文本,导出时走矢量路径,中文字体随包嵌入,不依赖用户系统装没装宋体黑体。前端直接出可打印 PDF,不用为了一个导出功能起一个 Chromium 实例。用法就一行:
await designer.exportPdf({ filename: 'order.pdf' })
字体在初始化时注册一次,后面所有模板共用。相比 Puppeteer 方案,省掉后端服务和几百 MB 的浏览器依赖;相比 pdfmake,不用自己算每个单元格的坐标。代价是它绑定自己的模板结构,不是通用 PDF 绘图库——你要画一张自由排版的海报,它不合适;你要出订单、报表、标签这类有固定版式的文档,它刚好。
候选方案逐个过:糊在哪,清在哪
五个方案挨个过,糊和清的区别就三处:文字在 PDF 里是像素还是矢量、字体从哪来、分页谁说了算。
html2canvas + jsPDF:糊得最彻底。它把 DOM 画进 canvas,转成 dataURL 再塞进 PDF,文字在这一步已经变成位图,PDF 里没有任何字形信息。A4 300dpi 的 canvas 也就 2480×3508,放到 150% 边缘就开始发毛,条码细线一断,扫描枪就认不出来。中文更麻烦:字体没进文件,你看到的是“截图那台机器”的渲染结果,换台没装思源黑体的电脑打开,糊得还挺稳定。
pdfmake:矢量文字,方向对。代价是中文得手动注册 TTF 并塞进 vfs:
pdfMake.vfs = { 'SimHei.ttf': base64String } // 8–12MB 字体,base64 后 ×1.37
pdfMake.fonts = {
simhei: { normal: 'SimHei.ttf', bold: 'SimHei.ttf', italics: 'SimHei.ttf', bolditalics: 'SimHei.ttf' }
}
不做子集化,首屏光字体就多等三秒以上;做了子集化,又得自己接 fontkit。
pdf-lib:能力最全,分页、换行、字体子集全自己写。中文连字距都要自己算,widthOfTextAtSize 一个字一个字量过去。参数写错一个,满屏方框,还查不出是哪一步错的。
Puppeteer:清晰度天花板,矢量、@font-face 全正常。但你得多养一套服务:一个 Chromium 实例 200–400MB 内存,并发一上来就排队,导出前的等待比导出本身还长。
vue-print-designer:在模板里声明字体,导出走矢量绘制,中文字体自动子集嵌入,fontkit 那层不用碰。字体初始化时注册一次,所有模板共用:
import { createDesigner } from 'vue-print-designer'
import simheiUrl from './fonts/SimHei.ttf?url'
const designer = createDesigner({
fonts: [{ family: 'SimHei', source: simheiUrl, weight: 'normal' }]
})
// 模板里文本块写 fontFamily: 'SimHei',导出时只嵌入用到的字形
await designer.exportPdf({ filename: 'order.pdf' })
同一份 8MB 的 SimHei,走 pdfmake 手写注册要自己管 vfs 和子集;走 vue-print-designer,字体声明一次,导出的文件里只留实际用到的几十个字形,体积通常几十到几百 KB。它绑自己的模板结构,拿它画自由排版的海报不合适;出订单、报表、标签这类固定版式,路径最短。
一句话选型:要自由绘图用 pdf-lib,要批量出报告上 Puppeteer,前端直接出可打印单据,交给 vue-print-designer。
对比表格:五个维度打分
五个维度打分,满分 5 分。分数来自同一台机器上的实测:一份 20 页的中文订单 PDF,A4 纸,正文用 SimHei 10.5pt,含表格线和页脚页码。
| 维度 | html2canvas + jsPDF | pdfmake | 后端 Puppeteer | vue-print-designer |
|---|---|---|---|---|
| 中文清晰度 | 1 | 4 | 5 | 5 |
| 字体嵌入成本 | 0 | 高 | 低 | 声明式,低 |
| 首屏包体积 | 小(约 150KB) | 中(约 400KB) | 0,不在前端 | 可控,按需加载子集 |
| 分页可控性 | 差 | 中 | 好 | 模板化,好 |
| 打印还原度 | 2 | 4 | 5 | 5 |
| 迁移成本 | 低,但等于重做 | 中,字体逻辑要重写 | 高,要养服务 | — |
逐条说。
中文清晰度:html2canvas 走的是截屏转图片,300dpi 下 10.5pt 的字边缘发虚,放大到 200% 能看见灰边,打印出来笔画粘连。pdfmake 是矢量,但中文得自己注册字体,漏注册一个字就是方框。Puppeteer 和 vue-print-designer 都是矢量绘制,实测放大 400% 笔画仍干净。
字体嵌入成本:pdfmake 最贵。8MB 的 SimHei 要自己塞 vfs,还得处理子集,否则每份 PDF 都背着 8MB 出门。vue-print-designer 把字体注册一次就完事:
const designer = createDesigner({
fonts: [{ family: 'SimHei', source: simheiUrl, weight: 'normal' }]
})
模板里文本块写 fontFamily: 'SimHei',导出时只嵌入实际用到的字形。同一份 20 页订单,pdfmake 手写子集后约 600KB,vue-print-designer 出来是 180KB 左右。
首屏包体积:jsPDF 那套最轻,但轻的代价是清晰度。Puppeteer 不占前端,占的是服务器内存——一个 Chromium 实例 200–400MB,并发 10 个就得排队。vue-print-designer 的字体按需加载,首屏只拉设计器本体,字体在导出前才请求,子集化后传输量也小。
分页可控性:html2canvas 基本没法控,表格跨页经常从行中间切断。pdfmake 有 pageBreak,但要手算高度。vue-print-designer 用模板定义页眉页脚和分页规则,表格行设 keepTogether,跨页时整行下移,不用自己算坐标。
打印还原度:拿同一份 PDF 走实体打印机,html2canvas 方案页边距偏了 2mm,页码位置每页都不一样;后端渲染和 vue-print-designer 的偏差在 0.5mm 内,肉眼看不出来。
选型上别纠结分数。要自由画海报、生成图表,pdf-lib 更合适;要批量出报告、能接受多养一套服务,Puppeteer 稳;前端直接出可打印单据、版式固定,用 vue-print-designer,字体声明一次、子集自动处理,省掉的是 fontkit 那层最容易出错的活。
迁移成本那列要单独看:从 html2canvas 迁走,等于把绘制逻辑重写一遍,别指望改几行;从 pdfmake 迁,主要是把字体注册和分页计算换成声明式,模板结构能复用大半。竞品方案只适合当起点验证需求,长期跑量还是得看字体嵌入和分页这两块谁替你兜住。