先给结论:网页打印控件哪个好用
先给结论:同一份模板要在 Chrome 和 Firefox 里打出来一模一样,别指望裸调 window.print(),得用带模板层和渲染降级的打印控件。我们比了三轮,最后落在 https://gitee.com/theGreatOldFive/vue-print-designer。
选型只看三条,其他都是噪音:
- 能不能控
@page边距。Chrome 认@page { margin: 10mm },Firefox 对部分写法会忽略,边距直接回落到用户在打印对话框里的设置,同一张 A4 单子两边的表格宽度能差 8mm。 - 能不能固定缩放基准。Chrome 默认按 CSS 像素 96dpi 换算,Firefox 在部分缩放下会把
transform: scale()和分页算在一起,导致第二页开始内容整体偏移。 - 分页是否可预测。长表格跨页时,Chrome 认
break-inside: avoid,Firefox 对tr上的这条支持不稳,一行数据被劈成两半是常事。
三条都过的方案不多。对比下来:
| 方案 | 边距可控 | 缩放基准 | 分页可预测 | 适用场景 |
|---|---|---|---|---|
原生 window.print() |
弱,靠用户对话框 | 否 | 弱 | 纯文本单据、内部备忘 |
| html2canvas + jsPDF | 是(画布内) | 是 | 是 | 导出图片型 PDF,长表格会糊 |
| 浏览器插件类 | 是 | 是 | 是 | 部署成本高,运维不认 |
| vue-print-designer | 是 | 是 | 是 | 模板与执行分离,两端同一套配置 |
原生方案胜在零依赖,一段纯文本的收货单够用,但只要模板里有表格边框和分页,两端就开始各打各的。html2canvas 那条路我们试过:一张 30 行的对账单转出来 2.1MB,放大到 150% 字边发虚,客户直接退回。插件类要每台机器装,IT 部门一句话就否了。
它 的定位是模板设计 + 打印执行分离:模板在编辑器里定好纸张、边距、缩放基准,执行时 Chrome 和 Firefox 读同一份配置,内核差异在内部降级处理,业务代码不用写 if (isFirefox)。
本文按项目复盘讲:背景、取舍、踩过的坑、最终效果。代码都是能直接跑的片段,不贴伪代码。

业务背景:一份模板,两个内核,三种纸
后台系统要出三种纸:不干胶标签(60×40mm)、体检报告(A4)、工牌证件(85.6×54mm)。模板只在总部维护一份,下发到各门店电脑上打印。门店的浏览器环境不由我们决定:大约一半 Chrome,一半 Firefox,还有几台卡在 Firefox ESR 78 和 Chrome 8x 上。运维明确说不能强制升级,也不能逐台装插件,因为门店数量摆在那里。
第一版的做法很直接,模板渲染完调 window.print()。上线第二天,门店反馈集中到三处:
边距。 Firefox 默认打印边距会吃掉约 8mm 的页面内容区,Chrome 在同样设置下只留 5mm 左右。A4 报告左右两侧的表格线,两边量出来差 8mm,右边框直接被裁掉一截。
缩放。 Chrome 按 CSS 像素 96dpi 换算,Firefox 在部分系统缩放(125%、150%)下会把 transform: scale() 和分页计算混在一起,从第二页开始内容整体右移,越往后越明显。
分页。 长表格跨页时,Chrome 认 break-inside: avoid,Firefox 对 tr 上的这条支持不稳,一行体检指标被劈成上下两半,落在两张纸上。
这三条不是偶发,是稳定复现。我们试过用 @page { margin: 0 } 强制归零,Chrome 听话,Firefox 仍然保留一个不可控的安全边距;试过给 body 加固定宽度,结果标签纸在 Firefox 下被缩到 92%。改 CSS 改了两天,越改越像在给两个内核分别写样式,模板里开始出现 @-moz-document 这种只在一边生效的规则,维护成本立刻上去了。
验收标准是甲方写死的:同一模板在两个内核下,元素位置偏差 ≤ 1mm,分页点一致。拿这个标准去量,第一版没有一项达标。
所以结论得前置:这不是 CSS 写得好不好的问题,是打印链路缺一层可控的渲染配置。模板里写多少 mm、多少 pt,最终都要经过浏览器自己的打印管线,而这条管线在 Chrome 和 Firefox 里是两套实现,默认值不同、单位换算时机不同、分页算法也不同。业务代码在 CSS 层做补偿,等于在两个黑盒外面各贴一张膏药。
后来我们把模板配置抽出来,纸张尺寸、四边边距、缩放基准写在一份 JSON 里,由打印执行层统一读取,内核差异在那一层降级处理。业务页面不再关心当前是哪个浏览器:
js
const job = {
paper: { width: 60, height: 40, unit: 'mm' },
margin: { top: 2, right: 2, bottom: 2, left: 2 },
scaleBase: 1,
breakInside: 'avoid'
}
同一份 job 下发到门店,Chrome 和 Firefox 读到的边距、缩放基准是同一个值,不再依赖各自对话框里的默认选项。这一步做完,8mm 的偏差先被压到 1mm 以内,分页才有得谈。

方案取舍:三条路,最后都落到同一个控件
三条路线都试过,最后都落到同一件事上:打印链路里得有个东西接管模板和渲染执行。
路线 A:纯 CSS @page + mm 单位。 最省事,也最不顶用。Chrome 对 @page { size: 60mm 40mm; margin: 2mm } 基本照做,四边边距误差在 0.3mm 内。Firefox 对 @page margin 的支持只到"接受语法、不完全执行",你写 2mm,它实际留多少取决于打印机驱动和默认安全区,同一台机器上我们量到过 6.8mm。靠它兜底,等于把边距控制权交出去。
路线 B:html2canvas 截图再打印。 跨内核确实一致了,因为两个浏览器打的是同一张位图。但标签场景直接判死:60×40mm 的纸,二维码模块边长不到 0.3mm,截图按 96dpi 栅格化后再走打印机,扫码枪三次里过一次。条码同理,细条糊成灰带。清晰度靠放大倍数能救一点,文件体积和渲染时间又上去了,门店那台四年前的收银机扛不住。
路线 C:控件接管模板与执行。 模板里存 mm 尺寸和分页规则,运行时按内核注入不同样式。这也是我们最后选的路。以 该方案 为例,设计器产出模板 JSON,打印时统一算缩放基准:Chrome 走 @page,Firefox 走 transform: scale() 降级,两条分支的输入是同一个 scaleBase。
js
// 打印执行层:按内核选择注入策略
function buildPrintStyle(job, ua) {
const { paper, margin, scaleBase } = job
const isFirefox = /firefox/i.test(ua)
if (!isFirefox) {
return `@page { size: ${paper.width}mm ${paper.height}mm;
margin: ${margin.top}mm ${margin.right}mm ${margin.bottom}mm ${margin.left}mm; }`
}
// Firefox:@page margin 不可控,改为容器缩放 + 边距内缩
const innerW = paper.width - margin.left - margin.right
const innerH = paper.height - margin.top - margin.bottom
return `.print-root {
width: ${innerW}mm; height: ${innerH}mm;
margin: ${margin.top}mm ${margin.right}mm ${margin.bottom}mm ${margin.left}mm;
transform: scale(${scaleBase});
transform-origin: top left;
}`
}
scaleBase 不是拍脑袋定的。Firefox 下先按 100% 打一张,量出实际内容宽度与目标 mm 的比值,反算缩放系数写回模板配置,之后同一机型复用。我们门店那批机器收敛到 0.978 和 1.0 两档,元素位置偏差压到 0.6mm 以内,分页点跟 Chrome 对齐。
迁移成本是这条路线能落地的前提:老模板不用重画。把原来散在 CSS 里的纸张尺寸、四边边距搬进模板配置,页面代码只留一个调用,不再出现 @-moz-document 这种一边生效的补丁。改完之后,业务侧没人再问"这个模板在 Firefox 上为什么偏"。