仓里要打快递面单、货架标签、价签,少不了条码和二维码。设计器里拖一个码、绑上单号,预览能扫。接到业务一打:有的扫不出,有的变成黑洞,有的根本没渲染。
直说吧:
码在模板里是图形元素,出纸链路把它当普通内容渲染。扫不出,先分清是「模板没生成码」「打印发虚」「静区被裁」,别一上来改业务接口。
模板侧先钉死三件事
| 项 | 建议 |
|---|---|
| 码制 | 快递面单常见 Code128;商品价签 EAN-13;跳转/报文用二维码 |
| 内容来源 | 绑 {
{barcode}} / {
{qrContent}},别写死样例单号上生产 |
| 静区 | 码四周留白,别贴着边框或文字 |
EAN-13 对位数敏感,校验位不对会直接废。样本数据要用合法 13 位测,别用 123 糊弄预览。
导出后怎么打
import webPrintPdf from 'web-print-pdf';
async function printLabel(html, data, printerName) {
if (!(await webPrintPdf.utils.getConnectStatus())) {
throw new Error('本机打印客户端未运行');
}
const filled = html.replace(/\{\{(\w+)\}\}/g, (_, k) => (data[k] == null ? '' : String(data[k])));
return webPrintPdf.printHtml(
filled,
{
paperFormat: '60mm', // 按实际标签纸;常见还有 40×30、100×100
printBackground: true,
margin: {
top: '0', right: '0', bottom: '0', left: '0' },
},
{
printerName, copies: 1 },
{
action: 'print' }
);
}
标签纸型跟设计画布一致。面单若是 PDF 面单通道,那是另一条链路;这篇只谈 HTML 模板里画出的码。
扫不出时,按层排查
| 层 | 现象 | 处理 |
|---|---|---|
| 数据 | 码是空的或错单号 | 看替换后的 HTML,别看设计器样本 |
| 版式 | 码被裁一半 | 静区、标签高度、切刀位置 |
| 渲染 | 发虚、锯齿 | 热敏 DPI、缩放;前面热敏篇讲过成因 |
| 硬件 | 同一 PDF 别的机正常 | 碳带/热敏头/浓度 |
需要极高密度工业码、或打印机只认 ZPL/TSPL 时,HTML 画码可能不够——那是「发指令」路线,跟可视化 HTML 模板是两回事。多数仓储价签、面单辅助码,HTML 渲染够用。
排障表
| 现象 | 先查 |
|---|---|
| 预览能扫、纸上不能 | 驱动缩放、浓度、纸型 |
| 纸上是黑块 | 内容过长挤爆;或背景/反色异常 |
| EAN-13 设计器报错 | 位数/校验位不合法 |
| 二维码很大但扫不出 | 容错级别低 + 打印糊;先加大静区再查清晰度 |
| 只打出文字没有码 | 导出 HTML 缺码图资源;或替换后内容非法导致未生成 |
条码是模板元素,不是打印 API 的特殊参数。拖对、灌对、纸型对,再谈扫码枪——顺序反了会在 SDK 里空转一天。