结论先行:信创网页打印方案的差别在纸张名、边距、驱动三层
搜「UOS 打印纸不对」的人多半遇到同一件事:Windows 上跑得好好的模板,搬到统信 UOS 上,纸型变成 Letter,内容往左上角挤。问题不在前端打印 API------window.print() 在两个系统上的行为是一致的,差别在它下面三层:纸张名映射、边距单位换算、驱动与字体。
项目地址先放这儿,后面对照都在它上面复现:https://gitee.com/theGreatOldFive/vue-print-designer
第一层,纸张名。 Windows 驱动认 A4 两个字就够;CUPS 那边同一个纸盒可能叫 iso_a4_210x297mm,厂商 PPD 又可能写成 A4 210×297mm。名字对不上,队列就退回默认纸,A4 模板打到 Letter 上,右边少 6mm,表格最后一列被切。
第二层,边距单位。 Windows 打印票据里常见百分之一英寸或 0.1mm,CUPS 的 PageSize、PageRegion 走毫米。直接把 Windows 的边距数值透传过去,要么缩成十分之一,要么放大十倍,两种都见过。
第三层,驱动和字体。 UOS 侧多是 CUPS + Gutenprint 或厂商 PPD,同一台机器换个驱动版本,可打印区域能从 203.2×289mm 变成 210×297mm。字体是隐藏项:缺一款字,表格行高变了,分页位置跟着跑,十页文档多出一页空白。
三条常见路线的实测表现:
- 浏览器原生
print():改造成本最低,但纸张和边距全靠用户在对话框里点,批量打印时完全固定不住。 - Lodop 类控件:能显式指定纸型,方向是对的;但 UOS 上纸张别名和队列名照样得按目标机器逐台校准,跳不过这一步。
- 先转 PDF 再打:稳定性较好,代价是动态模板每次都要重渲染,批量 200 张以上耗时明显上去。
选型结论:信创项目别赌系统默认。用「模板设计器 + 打印控件」的组合,把纸张名、边距、队列三项写进配置,跟模板一起下发。做法不复杂:
js
// 打印参数显式声明,不读系统默认值
{
printer: 'HP-LaserJet-M1136', // CUPS 队列名,区分大小写
paperName: 'iso_a4_210x297mm', // 以 lpoptions -p <队列> -l 的输出为准
margin: { top: 8, right: 8, bottom: 8, left: 8 }, // 统一 mm
unit: 'mm'
}
这次的真实背景是统信 UOS 改造,同一套模板从 Windows 迁移过去。验收盯三个数:纸张名命中率(50 张里纸型正确的张数)、边距偏差(打印件四边实测值与模板设定值之差,单位毫米)、首张打印耗时(从点击到出纸)。
口径得先定死:同模板、同打印机、同驱动版本,Windows 和 UOS 各打 50 张,逐张量。不控制这三个变量,后面所有对比数字都白测。

方案取舍:保留模板资产,用打印控件适配 UOS
结论先给:模板不动,动打印层。迁移前把三条起点各打了一轮样张,问题很清楚。
原生 window.print() 改造成本最低,但纸张和边距全交给用户在对话框里选,批量打印时锁不住。测了 50 张,有 7 张被点成 Letter,边距每次都不一样。属于不可控。
旧式打印控件能显式写纸型,方向对。但纸型名和队列名跟着驱动走,同一台机器换个 PPD,iso_a4_210x297mm 就可能变成 A4,得重新校准。属于驱动耦合。
先转 PDF 再打印,版式最稳,代价在动态字段:金额、页码、二维码每次都要重渲染,200 张以上耗时是直接打印的两倍多。而且 PDF 送进队列时,纸型还是取系统默认。
所以取舍定三条:一,不重写业务模板;二,不把驱动差异硬编码进业务页面;三,打印能力整体下沉到适配层。
落到 vue-print-designer 上,模板 JSON 原样复用,字段绑定、表格结构、分页规则一行不改。新增的打印服务只做三件事:解析 CUPS 队列名、映射纸张别名、补偿边距。业务页面只传模板 ID 和数据,不出现任何打印术语。纸张映射外置成一张表:
js
// uos-paper-map.js ------ 按现场机器实测填,不写进组件
export default {
'A4': { paperName: 'iso_a4_210x297mm', margin: [8, 8, 8, 8] },
'A4-241': { paperName: 'iso_a4_210x297mm', margin: [8, 8, 8, 8], shiftX: -9.5 },
}
shiftX 是针式机实测出来的左偏移,量三张取中位数填进去,不靠猜。
旧控件只当搬运工:能导出模板就导出,导不出就拿一张打好的样张量尺寸,按毫米坐标重建,不围绕旧 API 写兼容层。为省两天适配去背一套废弃接口,后面每次升级都要还债。
验收盯两条:改模板不动业务代码------改一次表头列宽,业务仓库零提交;换打印机只改配置------队列名从 A 换到 B,重打一张,四边偏差不超过 1mm。这两条过了,UOS 这关就算过。

落地坑一:纸张名和边距全变,先钉死毫米单位
先给结论:纸张名不可信,毫米可信。
同一份模板,Windows 上打出来四边齐整。搬到 UOS,同一台打印机、同一个队列,第一张就歪了:右边多出 3mm,底部内容被切掉半行。查下去两个问题叠在一起。
一是纸型名。Windows 驱动报的是 A4,UOS 这边 CUPS 返回的是 iso_a4_210x297mm,换个 PPD 又变成 A4 210x297mm,还见过 A4-210x297。代码里写死 paperName === 'A4' 的判断,命中率实测只有 60% 左右,剩下 40% 悄悄回落到队列默认纸型------如果默认是 Letter,整页版式全错,还不报错。
二是边距。原模板用 px 存边距,96dpi 换算成毫米再交给驱动,四边偏差 2--4mm。原因不深究了,链路上至少两处各自做了取整。
做法三条:启动时枚举队列支持的纸型;按名称模糊匹配,匹配不上用尺寸兜底;模板边距统一存 mm,打印前做范围校验。
js
// paper.js ------ 跑在主进程,UOS 下走 CUPS
import { execFileSync } from 'node:child_process'
// 1. 枚举:lpoptions 输出形如 PageSize/PageSize:iso_a4_210x297mm,A4,...
export function listPapers(queue) {
const out = execFileSync('lpoptions', ['-p', queue, '-l'], { encoding: 'utf8' })
const line = out.split('\n').find(l => l.startsWith('PageSize'))
return line ? line.split(':')[1].trim().split(',') : []
}
const A4_MM = [210, 297]
const norm = s => s.toLowerCase().replace(/[\s_\-]/g, '')
// 2. 匹配:先按名字模糊,再用尺寸兜底,最后才回落第一项
export function pickPaper(list, want = 'A4') {
const byName = list.find(p => norm(p).includes(norm(want)))
if (byName) return byName
return list.find(p => {
const m = p.match(/(\d{3})\s*[x*×]\s*(\d{3})/)
return m && Math.abs(+m[1] - A4_MM[0]) <= 1 && Math.abs(+m[2] - A4_MM[1]) <= 1
}) || list[0]
}
边距这边反过来做:模板里只存 [8, 8, 8, 8] 这种毫米数组,预览和打印共用同一份数值。交给浏览器排版时不再换 px,直接拼 @page:
js
export function buildPageRule(margin, w = 210, h = 297) {
const m = margin.map(Number)
if (m.length !== 4 || m.some(v => !Number.isFinite(v) || v < 0 || v > 50)) {
throw new Error(`边距越界(mm): ${margin}`)
}
// size 写毫米,不写系统纸名,驱动认不认名字都不影响版心
return `@page { size: ${w}mm ${h}mm; margin: ${m.map(v => v + 'mm').join(' ')}; }`
}
落点上,把纸张映射外置成一张配置表(现场机器实测填),表和组件分仓维护;设计器画布、预览、实际打印三处共用同一套 mm 单位,模板 JSON 里不出现任何系统纸型字符串。
实测一台奔图、一台爱普生针式:纸型名命中率 60% → 100%(尺寸兜底接住了 3 个别名);四边偏差从 2--4mm 压到 1mm 内,针式机另加 shiftX 补偿后也在 1mm 内。排查成本降得更多------之前每换一台机器要先打三张样张量尺寸,现在看日志里匹配到哪个纸型名就行。
落地坑二:字体、缩放、队列名,别在业务代码里打补丁
这三个坑的共同点:都能在打印层收口,别让业务页面知道系统是哪个。
字体:缺了不报错,版式先乱
UOS 干净装机常没有宋体、黑体,条码字体更容易缺。缺字体不会抛异常,浏览器直接回退,结果 12pt 文字变宽,模板里固定 38mm 的条码被拉成 41mm,扫码枪读不出。打印前先预检,缺字体就拦住并给出包名,别等打完才发现换行。前端 document.fonts.check 对本地字体并不可靠,放到打印服务里查更稳:
js
import { execSync } from 'node:child_process'
const REQUIRED = ['Noto Sans CJK SC', 'LibreBarcode39-Regular']
export function checkFonts() {
const families = execSync('fc-list : family').toString()
const miss = REQUIRED.filter(f => !families.includes(f))
if (miss.length) throw new PrintError('E_FONT', `缺少字体: ${miss.join(', ')}`)
}
模板里字号只写 pt,线宽、条码宽只写 mm,行高不带单位。预览容器用 mm 定宽,缩放只作用在外层 transform,不写回模板。
缩放:屏幕比例不该进打印参数
系统 125%/150% 只影响屏幕像素。预览如果拿 devicePixelRatio 算画布,换台机器就偏。模板存 baseDpi: 96,预览按基准渲染再 CSS 缩放;打印固定 1:1,不读取系统缩放。
队列名和权限:现场一换就炸
Windows 队列名常见 Microsoft Print to PDF,UOS 走 CUPS,队列名可能是 PDF、LBP2900,静默打印还要 lp 组权限。名字硬编码在页面里,换现场就得改代码。队列名走配置,空则取系统默认:
js
export const printProfile = {
baseDpi: 96,
scale: 1,
queueName: '', // 现场在配置中心填
silent: true,
onError: 'preview'
}
队列为空或 lp 返回 Forbidden,统一转成 E_QUEUE、E_PERM,回退预览并显示可读原因,不白屏。
这套判断放在打印服务层,设计器预览和实际打印读同一份 profile,参数配置化;异常返回错误码和中文原因,由页面决定是否回退预览。它 在这里只做一件事:预览与打印同源,业务页面不碰系统差异。
业务页面里不要写 if (isUOS) 改字号、改边距。补丁会从一张报表扩散到每一张,最后没人敢删。改完后现场统计:重打率从 7% 降到 2% 以内,首张打印耗时从 8s 降到 3s 左右------省掉的是反复选纸、重试和人工量尺寸。