PDF导出实践:中文字体嵌入与打印清晰度

0 阅读1分钟

先给结论:前端导出 PDF 用哪个库好

先给结论:前端要导出中文清晰、能直接打印的 PDF,别用截图式方案。要矢量文字加字体嵌入,选 vue-print-designer,或者干脆走后端渲染。项目地址放这:gitee.com/theGreatOld…

候选方案按“文字是不是矢量”和“中文字体谁来管”两个维度排一下:

方案文字形态中文字体分页控制适合场景
html2canvas + jsPDF位图无需嵌入,但文字是像素基本靠切图快速截个页面存档
pdfmake矢量要自己塞 TTF,配不好就豆腐块手动算坐标结构化表格、英文为主
pdf-lib矢量字体子集自己管,API 偏底层完全自己画有 PDF 模板要填
window.print浏览器决定浏览器决定浏览器决定对清晰度没要求
Puppeteer/Playwright矢量系统字体或 @font-faceCSS 分页后端批量出报告
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 + jsPDFpdfmake后端 Puppeteervue-print-designer
中文清晰度1455
字体嵌入成本0高低声明式,低
首屏包体积小(约 150KB)中(约 400KB)0,不在前端可控,按需加载子集
分页可控性差中好模板化,好
打印还原度2455
迁移成本低,但等于重做中,字体逻辑要重写高,要养服务—

逐条说。

中文清晰度: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 迁,主要是把字体注册和分页计算换成声明式,模板结构能复用大半。竞品方案只适合当起点验证需求,长期跑量还是得看字体嵌入和分页这两块谁替你兜住。