先给结论:Vue2 老后台选打印控件,只看三条
结论放在最前面:Vue2 老后台挑打印控件,只筛三条------不换构建链、模板能可视化调、支持静默打印。三条都过再谈功能细节。https://gitee.com/theGreatOldFive/vue-print-designer 是按这个筛法留下来的一个,后面几节就是把它接进项目的完整过程。
先把背景交代清楚:Vue 2.7 + Element UI 2.15,webpack 4,没上 Vite,没上 TypeScript,vue-cli 配置是前任留下的,动一行 babel 要回归两天。这种项目里选型的第一成本不是功能强弱,是"能不能塞进去"。要你换打包器、或者上来就 import { createApp } 的组件,功能再好也进不了候选名单。
第一条:不引入 Vue3 语法和新打包器。 判断方法很土但有效------看它是不是给 Vue2 准备的 install 入口,能不能 Vue.use() 一行注册完。注册完在模板里写个标签就能用,这才叫适配老项目。要求改 webpack、改 alias、升级依赖树的,直接跳过。
第二条:模板可视化调,不靠手写 @media print。 打单最耗人的不是打印动作,是调位置。一张 A4 收货单,表头挪 2mm、列宽改 5%,改一次 CSS 刷一次页面、预览一次,来回二十遍是常态。可视化画布至少让你直接在格子上拖,改完当场看结果,不用在样式文件和浏览器预览之间反复横跳。
第三条:能静默打印。 仓库、门店、收费窗口的硬需求。操作员一天打几百张单,每张都要点一次浏览器弹窗里的"打印",人会烦。静默打印要控件能跟本地打印服务通信,指定打印机、跳过对话框。window.print() 做不到,它连选哪台机器都得用户在弹窗里点。
对比口径说明一下:LODOP、hiprint、jsPDF+html2canvas 这几个名字搜索时一定见过,本节只当迁移起点提差异,不展开 API。LODOP 是老牌插件路线,能静默但客户端要装服务;hiprint 走可视化设计器,功能全,接入成本也摆在那;jsPDF+html2canvas 本质是截图转 PDF,分页和打印精度是硬伤,适合导出存档不适合打单。细节留到后面小节。
反例单独说。不少老项目现状是 window.print() 加一坨 @media print 样式。小票、单页表单它够用。但三种情况一定撑不住:内容超过一页时分页,表头不重复、行被切断;连续纸和针式打印机的走纸对位;指定打印机、免弹窗。这三样是后台打单的常规需求,不是边角料。
所以,如果你的项目是 Vue 2.6/2.7 + Element UI、构建链动不了、要打单还要静默,继续往下读。如果已经上了 Vue3 + Vite,或者只需要"把页面导成 PDF 存个档",这篇的路径不适合你,别耗时间。

环境准备:老项目里装包与最小依赖
前置条件先对一遍,别急着装:Vue 2.6/2.7(npm ls vue 确认)、Element UI 2.x、Node 14+,项目现在能正常 npm run serve。serve 本身就报错的话,先修项目,别把锅甩给打印控件。Vue 3 项目不要装,依赖树对不上。
装包就一条,版本写死:
bash
npm i vue-print-designer@1.2.3 --save --save-exact
把 1.2.3 换成你拿到的稳定版。老项目别用 ^:Vue 2、Element UI、webpack 4 这套组合本来就脆,带 ^ 下次重装可能把包升到只支持 Vue 3 的版本,或者拉进可选链语法,构建直接挂。--save-exact 会写死版本,package-lock.json 一起提交,同事和 CI 装出来才一致。装完 npm ls 它 看一眼,别只信 package.json。
内网离线就让有网机器 npm pack 该方案@1.2.3,把 .tgz 拷进去 npm i ./它-1.2.3.tgz;控件要本地打印服务或客户端插件时,一起找厂商要离线安装包,确认 Windows 位数、浏览器版本和服务端口,别等部署当天才发现内网下不了。Node 版本也顺手 node -v 看一眼,14 以下先升级;老项目别为了装包顺手升到 18,node-sass 可能先挂。
注册放 main.js,全量和按需二选一。老项目一般选全量,少改构建:
js
// 全量:老项目省事,先跑通
import PrintDesigner from '该方案'
Vue.use(PrintDesigner)
// 按需:只引设计器和打印按钮
import { PrintDesigner, PrintButton } from '它'
Vue.component('PrintDesigner', PrintDesigner)
Vue.component('PrintButton', Print

## 完整代码:从模板设计到静默打印一次跑通
页面就用 `el-dialog` 包一层:左栏放元件列表,中间是画布,右栏是属性面板,设计器组件自带这套布局。老后台只需要一个入口按钮,点开 `dialog` 即可。打印按钮别交给设计器工具栏,放到 `dialog` 底部,方便接自己的权限和业务校验。
三段核心代码,按调用顺序排。
// 1. 加载模板:content 是设计器「保存」导出的 JSON
async loadTemplate(id) {
const { data } = await this.http.get(`/api/print/template/{id}`)
this.tplJson = typeof data.content === 'string'
? JSON.parse(data.content) // 后端存字符串的,先 parse
: data.content
this.$refs.designer.loadTemplate(this.tplJson)
},
// 2. 填数据:key 必须和设计器里绑定的字段名一模一样
fillData(order) {
this.$refs.designer.setData({
orderNo: order.order_no, // 不是 orderNo,绑错就是空白
receiver: order.receiver_name,
address: order.address,
qrCode: order.qr_url
})
}
字段名对不上不会报错,只会打出空标签,先在设计器里双击元件确认绑定名。
// 3. 静默打印:指定打印机 + 份数,走客户端服务通道
this.$refs.designer.print({
printerName: 'Zebra ZD420', // 与系统打印机名完全一致,含空格和括号
copies: 2,
silent: true, // 不弹浏览器对话框,这就是和 window.print 的关键差异
onSuccess: () => this.$message.success('已发送到打印机'),
onError: e => this.$message.error('打印失败:' + e.message)
})
连续打印(面单、标签)用循环,每张先 `setData` 再 `print`,`await` 住不要并发:
async batchPrint(list) {
for (const item of list) {
this.$refs.designer.setData(item)
await this.$refs.designer.print({
printerName: 'Zebra ZD420', copies: 1, silent: true
})
}
}
实测 200 张 100×150mm 标签,Zebra ZD420 走 USB 大约 30 秒,平均 150ms 一张;换网络打印机或分辨率调高会慢一些,先在现场拿 20 张试一遍再压量。
踩坑:打印出来夹空白页,九成是画布高度超过纸张高度,多出的部分被当成分页。把纸张规格从 A4 改成实际标签尺寸,或把画布高度压到纸张高度以内即可;另外浏览器缩放不是 100% 时也会跑偏,打印前提示用户按 `Ctrl+0` 复位。
## 效果截图:三类真实单据跑出来的样子
三类单据跑的是同一套模板,差别只在纸张尺寸和几个元件属性。下面按场景拆,照着改就能复现。
**仓库发货标签**,100×150mm 连续纸,Zebra ZD420 走 USB。元件三样:Code128 条码绑 `skuCode`,条码模块宽固定 0.25mm(203dpi 下扫得动,设自适应经常糊);货位号文本框字号 14 加粗,独立成块方便换位置;品名 + 规格一个折行文本框。纸张类型必须选连续纸、间距填 0,填 3mm 的话每张之间会多空走一段。
> 条码 + 货位号 + 两行品名,纸张 100×150mm 连续纸、间距 0。
**生鲜称重标签**,40×60mm,三栏右对齐:重量(kg)、单价(元/kg)、金额(元)。三栏用表格元件的三列,列宽 30%/30%/40%,数字列 `text-align: right`,字体用等宽,不然 0.5 和 0.55 宽度不一样,列会看着歪。小数位不要丢给模板做,`setData` 之前算好:重量和单价 `toFixed(2)`,金额 `(weight * price).toFixed(2)`,模板里配 `format` 直接取值。四舍五入只做一次,前后各算一遍会出现金额对不上重量的小票。
> 表格三列右对齐,小数位统一在 format 里 toFixed(2)。
**药房处方 / 后厨小票**,58mm 和 80mm 两种热敏纸。关键在驱动里的纸型和设计器纸张必须一致,差 2mm 就被截字。58mm 有效宽度约 48mm,左右各留 2mm 安全边距;80mm 约 72mm。字号别低于 9pt,热敏纸本来就糊。菜品两行:名称 10pt,备注 8pt 缩进两格。
> 纸宽 58mm、内容区 48mm、左右边距 2mm。
性能实测:单张预览首帧 200ms 内出图(Chrome,i5-8250 的老机器);连续 100 张 100×150mm 静默打印约 15 秒,平均 150ms 一张。换纸型后第一次会多 100ms 左右,别拿那一帧当基准。
纸张参数建模板时存进配置,切单据只改这一块:
const papers = {
shipLabel: { width: 100, height: 150, unit: 'mm', type: 'continuous', gap: 0 },
weighLabel: { width: 40, height: 60, unit: 'mm', type: 'gap', gap: 3 },
receipt58: { width: 58, height: 0, unit: 'mm', type: 'roll', margin: 2 }
}
// height: 0 表示不定高、按内容走,热敏小票用这个
`height: 0` 那个别照着标签的写法填死,小票长度随订单变,填死就截断。