先给结论:要纸走控件直打,要归档件才走 PDF 导出
先给一句话选型:交付物是纸,走浏览器打印控件直打;交付物是文件,走 PDF 导出。发票、标签、快递单、成绩单属于前者,合同归档、审计留痕、邮件附件属于后者。这个判断在项目启动时做一次,比上线后返工便宜得多。
两条路线不是替代关系,是同一条链路上的两个终点。模板、数据、分页逻辑共用,只有最后一步不同:一个把像素交给打印机驱动,一个把像素封进 PDF 容器。混用才出问题,比如拿 PDF 导出件去喂热敏标签机,纸张边距对不上;或者拿控件直打的结果当归档件,同一张单子两次打印的换行位置都不一样。
实测数据先摆出来。同一张 A4 发票模板,字段 40 个左右,含一个二维码:
| 路线 | 首张耗时 | 可复现 | 可批量 |
|---|---|---|---|
| 控件直打 | 300--600ms(含弹窗) | 否 | 否 |
| PDF 导出 | 800--1500ms(含字体嵌入) | 是 | 是 |
控件直打快在跳过了字体子集化和文件序列化,代价是结果不受控。PDF 导出慢的那 500--900ms 基本花在中文字体嵌入上,换来的是字节级可复现------同一份数据今天导和半年后导,文件哈希一致,审计才认。
这里必须吐槽一句:浏览器打印弹窗是唯一一个你无法用 CSS 控制、无法用 JS 监听、各家实现还不一样的系统级 UI。Chrome 的边距选项、Firefox 的缩放默认值、Safari 的「打印背景图形」勾选框,位置和语义全不同。你在页面上调了三天 @page,用户点一下「取消」旁边那个「更多设置」,一切归零。很多人一开始就走错路,就是因为把「打印预览里看着对」当成了验收标准,结果换台机器就崩。
vue-print-designer 的做法是一套模板同时产出「打印」和「导出」两个出口,排版只维护一份。模板里定义纸张、页边距、分页规则和元素坐标,运行时按目标切换渲染器:走打印就输出到 iframe 触发 print(),走导出就把同一棵布局树交给 PDF 生成器。
js
const designer = usePrintDesigner({
template: invoiceTpl, // 同一份模板
data: invoiceData,
paper: 'A4',
margin: [10, 10, 10, 10] // mm
})
// 出口一:交付物是纸
await designer.print({ silent: false })
// 出口二:交付物是文件
const blob = await designer.exportPDF({ embedFonts: true })
两个出口共用分页计算,所以「打印出来第 3 页断在哪」和「PDF 第 3 页断在哪」是同一个答案。这一点在批量场景下省事:1000 张快递单直打,和 1000 份对账单归档,模板只改一个调用。
回到选型。先问交付物落在哪:落在纸上,控件直打,别为了「统一技术栈」硬上 PDF 再转打印,多一道转换多一层字体坑;落在文件上,走导出,别指望用户自己按 Ctrl+P 存 PDF,那个弹窗里的「另存为 PDF」在部分浏览器版本里连页眉页脚都关不掉。

候选方案盘点:三条路,别只盯着两条
先别急着二选一。实际能走的路线有三条,很多人只盯着前两条,结果在第三条上多花两周重做。
路线 A:window.print() + @media print。 最轻,零依赖,一个按钮就能触发。代价是控制权全在浏览器手里:Chrome 默认页边距约 10mm、Firefox 的缩放默认不是 100%、Safari 要用户手动勾选「打印背景图形」。@page { size: A4; margin: 12mm } 写了也不一定生效,因为用户在系统对话框里改一次设置,你的样式就作废。分页更被动,break-inside: avoid 只能建议,浏览器想在哪断就在哪断。
路线 B:ActiveX / 本地打印控件。 典型代表是 LODOP 这一类。它能拿到打印机底层能力:指定纸盒、免弹窗直打、精确到毫米的边距、逐份打印。代价同样明确:每台机器装客户端,ActiveX 只有 IE 内核支持,Chrome 需要另装扩展或本地服务,Mac 和 Linux 基本没法用。
路线 C:PDF 导出。 前端 pdfmake / jsPDF,或服务端 Puppeteer / wkhtmltopdf。产物稳定,同一份输入永远同一份输出,适合归档。但交互链路长:生成、下载、用户再打开、再打印,多出来的每一步都可能出问题。中文字体不嵌入就是一堆方块,Puppeteer 冷启动单页 1--2 秒起步。
五个维度拉平对比:
| 维度 | A 浏览器打印 | B 本地控件 | C PDF 导出 |
|---|---|---|---|
| 装客户端 | 否 | 是 | 否 |
| 首张耗时 | < 1s | 1--2s | 2s+ |
| 分页可控 | 弱 | 强 | 强 |
| 批量能力 | 差(逐张弹窗) | 强 | 强 |
| 跨浏览器一致 | 差 | 不适用 | 好 |
vue-print-designer 没有在三者里选一个,而是各取所需:路线 A 的控制力短板用设计器补------可视化拖拽分页线、纸张预设(A4/A5/快递单 100×180mm)、页眉页脚在模板里画好,运行时输出到 iframe 再触发 print(),绕开页面自身样式干扰;路线 B 的免弹窗诉求用打印代理兜底,装一个本地服务就能静默直打,不装则退回 A;路线 C 复用同一份模板 JSON,换个渲染器直接出 PDF,不用重画一遍。
js
// 同一份模板,三个出口
await designer.print({ silent: false }) // A:走浏览器
await designer.print({ silent: true }) // B:走本地代理,免弹窗
const blob = await designer.exportPDF() // C:出文件
迁移成本也说一句:已有 LODOP 模板的,按模板结构把纸张、边距、元素坐标映射过来即可,不用从头画。
选型顺序建议:先看交付物是纸还是文件,再看批量规模和是否允许装客户端。三个问题问完,路线基本就定了。

对比表格:五个维度拉平看
选型时最容易吵起来的是「哪个方案更好」,其实这个问题没有统一答案。把五个维度列出来,对着交付物看,答案基本就出来了。
| 方案 | 装客户端 | 首张耗时 | 分页精度 | 批量 | 浏览器一致性 | 适用交付物 |
|---|---|---|---|---|---|---|
| A 浏览器原生打印 | 否 | 300--600ms | 中 | 弱(逐张弹窗) | 差,Chrome、Firefox、Safari 三套逻辑 | 零星几张纸 |
| B 本地打印控件或代理 | 轻量代理 | 300--600ms(代理常驻) | 中 | 强 | 不适用(走系统驱动) | 免弹窗、指定纸盒 |
| C PDF 导出 | 否 | 800--1500ms | 高(模板定死) | 强 | 好 | 归档件、电子回单 |
| vue-print-designer | 否(B 需代理) | 同 A、C | 高 | 强 | 好 | 一套模板双出口 |
逐个维度解释。
装客户端这一列,A 和 C 都是零安装,用户点一下就行。B 要装一个本地服务,哪怕只有几 MB,在企业内网也意味着要走一次 IT 审批,这是真实成本,不要低估。
首张耗时差距来自渲染链路。A 直接把 DOM 交给浏览器打印管线,300--600ms 是 30 行明细表的量级;C 要先排版再生成 PDF 字节流,800--1500ms 起步,Puppeteer 冷启动还得另算。如果用户是「点一下马上拿纸」,这 1 秒的体感差异很明显。
分页精度是分水岭。A 的分页由浏览器决定,page-break-inside: avoid 不是所有引擎都老实执行,表格跨页断在合计行上的事故不少见。C 的模板里分页线是画死的,第几行换页在生成前就确定了。vue-print-designer 在这块做的是可视化拖拽分页线,A4、A5、快递单 100×180mm 都是预设,页眉页脚直接在模板里画,不依赖 CSS 的 @page 边距。
批量能力,A 最弱:十张单子就是十次弹窗,用户得点十次确认。B 和 C 都能一次跑完,C 还能打包成一个多页 PDF。
浏览器一致性,A 是三套排版逻辑,同一份模板在 Chrome 和 Safari 下边距能差出几毫米。C 由自己的渲染器出图,跨浏览器一致。
结论按交付物写:要纸,走 A;要归档件,走 C;既要免弹窗又要指定纸盒(比如发票走专票纸槽),走 B 或挂一个本地代理。
vue-print-designer 在这一行单列,是因为它不逼你二选一:同一份模板 JSON,三个出口只是调用参数不同。
js
await designer.print({ silent: false }) // A:浏览器弹窗
await designer.print({ silent: true }) // B:本地代理静默直打
const blob = await designer.exportPDF() // C:出文件归档
从 A 切到 C 不用重画模板,改一个调用就行。
表里的数字口径说明一下:测试机 i5-1135G7 / 16G 内存 / Chrome 120,模板统一为 30 行明细表,不含网络传输。只作量级参考,换机器、换模板复杂度都会浮动,别拿去当验收指标。