1. 先把这两个方言的底细摸清楚1.1 出身不同决定了它们的写法天生不一样斑马打印机上跑的 ZPL 和 EPL本质上不是新旧两代的关系而是两条技术路线在同一个品牌下并存。ZPL 全称 Zebra Programming Language是斑马自家原生的标签描述语言从早期的工业机型一路演进到 ZPL II现在几乎所有在售机型都以它为主力。EPL 全称 Eltron Programming Language来自早年做桌面条码打印机的 Eltron 品牌那家厂商被收购之后这条产品线的指令集被保留了下来后来演化出 EPL2主要服务于桌面级小机器和存量老设备。这个出身差异带来的直接后果是ZPL 更像一套版面描述系统它假设你要排版、要放条码、要放图形、要放变量所以指令设计得比较完整一条命令带一堆参数EPL 更像逐行画图指令它假设标签结构简单、内容固定能用最少的字符把一张面单画出来就行。你如果只打过物流面单可能觉得两者差不多一旦要做带二维码、带可变数据、带中文字体的复杂标签差距立刻显出来。我在实际项目里遇到最多的情况是新采购的机器默认吃 ZPL但车间里那批用了七八年的桌面机只认 EPL两边共用一套业务系统就得同时维护两套模板。不理解它们的差异模板改一处崩一处排查起来非常痛苦。1.2 命令风格符号流与字母指令的正面碰撞ZPL 的指令几乎都以^或~开头后面跟一到两个字母再跟一串逗号分隔的参数。比如^FO100,100定位、^A0N,40,40选字体、^FD开始写数据、^FS结束这个字段。整套格式被^XA和^XZ包起来形成一个完整的标签格式。EPL 则干净利落得多命令基本都是单字母或双字母参数同样逗号分隔没有成对包裹的概念。N清空缓冲区A10,10,0,4,1,1,N写一行字B10,50,0,1,2,6,80,B打一个条码P1打印一张。你把命令一条条发过去打印机就一条条执行最后统一出纸。这个差异看起来只是写法问题实际影响很大。ZPL 的^XA...^XZ结构天然支持整块下发、整块取消中途出错可以直接丢弃整个格式EPL 是流式的一旦前半截已经进缓冲区后面出问题只能靠N清掉重来。做批量打印时ZPL 更容易做事务式控制。1.3 机型与固件支持是选语言的现实约束ZPL 的支持面非常广从桌面机到工业机基本全覆盖固件更新也比较勤新命令比如更完整的二维条码、Unicode 编码优先在 ZPL 上实现。EPL 的处境就比较尴尬它是为了兼容老设备而保留的新机型上通常以EPL 兼容模式的形式存在能跑常见命令但一些高级特性会缺。具体来说早期以 LP、TLP 开头的桌面系列很多只支持 EPL这类机器在仓储、门店、小工厂里还有大量存量。后来的 ZD、ZT、GX 系列以 ZPL 为主部分型号可以在驱动或固件里切换语言切过去之后 EPL 命令能认但不保证 100% 行为一致。注意所谓支持 EPL 兼容很多时候是固件里做了一层解释器把 EPL 命令翻译成内部格式。翻译层不可能覆盖全部命令尤其是图形下载、特殊字符集、状态查询这几块容易出现命令没报错但效果不对的情况。判断一台机器到底能不能稳定跑 EPL最靠谱的办法是拿真实模板实测别只看参数表。2. 核心语法逐项对照别只看表面2.1 标签结构一个成对包裹一个顺序执行ZPL 的骨架非常固定^XA ^PW812 ^LL1218 ^FO50,50^A0N,40,40^FDHello^FS ^FO50,120^BY3^BCN,100,Y,N,N^FD1234567890^FS ^XZ^XA开始^XZ结束中间每一条^FO...^FS是一个独立字段。^PW设打印宽度^LL设标签长度单位都是点dot。这种结构的好处是可以把整段存进打印机做模板^DF存、^XF调用也可以在主控端拼接变量后整段发送。EPL 没有这层包裹一段典型的标签是这样N q812 Q1218,24 A50,50,0,4,1,1,N,Hello B50,120,0,1,2,6,100,B,1234567890 P1N清缓冲区q设标签宽度Q设标签长度和间隙中间逐条画内容P1打印一张。这里没有结束符打印机收到P就认为这一批可以出纸了。所以 EPL 模板的边界是靠N和P划出来的一旦中间某条命令参数写错后面的内容可能整体错位。我个人的习惯是写 EPL 模板时第一条永远是N最后一条永远是P中间不夹任何空行和注释以外的内容避免固件解析时把换行当成异常。2.2 坐标与分辨率点阵原点是所有偏移问题的根源两种语言都用点作为默认单位但换算关系必须记牢203 dpi 的机器大约是 8 点/毫米300 dpi 大约是 11.8 点/毫米600 dpi 大约是 23.6 点/毫米。同一张 100mm 宽的标签在 203 dpi 机器上宽度约 800 点在 300 dpi 机器上约 1180 点模板里的坐标必须跟着变否则要么内容被截断要么缩在左上角一小块。ZPL 里控制原点和尺寸的主要是^LH标签 home 偏移、^LT标签偏移、^FO字段原点、^PW打印宽度、^LL标签长度。^FO的坐标是相对于标签左上角的但会受^LH影响。很多打出来整体偏左 5mm的问题最后查出来是^LH残留了一个旧值。EPL 里对应的是O原点偏移、q/Q宽度、A/B命令自带坐标。EPL 的坐标原点是打印头起点O命令可以把整体内容平移做机械误差补偿时很实用。实操心得换机器或换分辨率时别急着手改坐标。先在模板里把宽度、长度按新分辨率算一遍用比例缩放生成新坐标再人工微调。我吃过一次亏203 dpi 的模板直接丢到 300 dpi 机器上打条码高度不够扫不出来现场排查了半天才反应过来是分辨率差异。2.3 字体与文字排版可缩放与固定点阵的区别ZPL 的字体体系以^A命令为核心^A0N,高度,宽度调用可缩放字体后面的字母A、B、D、F、G、H 等对应内置字体集还能通过^CW加载外部字体。斜体、反白、旋转都在命令参数里控制排版自由度很高。EPL 的A命令参数是固定顺序A x,y,旋转,字体号,横向倍数,纵向倍数,反白,内容。字体号只有 1 到 5 这几种内置点阵字体字号靠横向、纵向倍数放大放大会出现明显的锯齿。想要平滑字体得靠外部字体下载或者干脆改用图形方式打印。这个差异直接决定了适用场景ZPL 适合做需要精细排版的标签比如带公司名、规格说明、多行文字的成品标签EPL 适合做信息为主、排版为辅的面单字号放大两倍能看清就行。2.4 条码与二维码ZPL 的原生优势区ZPL 的条码命令按类型分开^BC是 Code128^B3是 Code39^BQ是 QR 码^BX是 DataMatrix^BY统一设置窄条宽度、宽窄比和条码高度。参数虽多但语义清晰一维二维都能原生支持。EPL 的条码命令统一是B靠 type 参数区分码制常见的是 1 对应 Code39、2 对应 Code128、3 对应 UPC-A、5 对应 EAN13 等。二维条码在老版本 EPL 里支持很弱QR 码往往要依赖固件版本有的机器干脆不支持只能用图形方式把二维码当图片打。这是迁移时最容易踩的坑一张带 QR 码的标签从 ZPL 迁到 EPL如果目标机器固件不支持二维命令模板不会报错但二维码位置会空着。解决办法是把二维码预渲染成点阵图形用图形命令下载后打印代价是灵活性下降变量内容没法动态生成。2.5 图形与图像一个支持压缩流一个偏原始点阵ZPL 的^GF图形字段支持多种数据格式包括 ASCII 十六进制、原始二进制、以及带压缩的编码方式。压缩这一点很关键一张 800×600 点的黑白图未压缩数据量很大压缩后能降一个数量级传输和缓存压力都小很多。EPL 侧的图形处理相对原始通常是把点阵数据按行写入打印机内存再按名字或位置调用。数据量大时传输慢而且不同固件对图形缓存的容量限制不一样图稍微大一点就可能被截断。做 logo 打印时我的建议是能用 ZPL 就用 ZPL 的压缩图形非要用 EPL先把 logo 转成单色、去掉灰阶、裁掉空白边把数据量压到最小再考虑分块传输。2.6 打印参数浓度、速度、介质模式的设置位置ZPL 把这些放在格式内部^PR设速度^MD设浓度^MN设介质类型^JM设分辨率相关参数。优点是模板自带参数换机器不用重新配缺点是如果模板里的值和现场纸张不匹配出纸效果会莫名其妙。EPL 的D设浓度、R设速度通常放在模板开头和N、q、Q挨在一起。这些参数是全局生效的发一次之后会保持直到下次被覆盖。注意浓度参数对热敏纸和铜版纸的影响完全相反。热敏纸浓度调高容易发黑糊边铜版纸热转印浓度不够则条码边缘发虚、扫不出来。EPL 模板迁移到 ZPL 时浓度值不能直接照搬需要重新试打三档低、中、高再定。3. 拿一张真实标签两种语言各写一遍3.1 先把需求定义清楚假设要做一张 100mm × 60mm 的资产标签203 dpi 机器内容包括标题文字一行、资产编号一行、Code128 条码一个、右下角一个 QR 码、左上角一个小 logo。宽度换算成点约 800长度约 480。这个需求覆盖了文字、一维码、二维码、图形四类元素正好能体现两种语言的差异。3.2 ZPL 版本的写法与逐行解释^XA ^PW800 ^LL480 ^PR4 ^MD15 ^LH0,0 ^FO20,20^GFA,1200,1200,40,...^FS ^FO150,30^A0N,36,36^FD资产标签^FS ^FO150,90^A0N,28,28^FD编号: A-2024-0001^FS ^FO40,160^BY3^BCN,90,Y,N,N^FDA-2024-0001^FS ^FO600,300^BQN,2,5^FDQA,A-2024-0001^FS ^XZ^PW800和^LL480定义画布^PR4是速度档^MD15是浓度。^FO定位每个字段^A0N,36,36是高度宽度都为 36 点的可缩放字体^BCN,90,Y,N,N表示 Code128、条码高 90 点、打印可读字符、字符在条码下方。^BQN,2,5是 QR 码模型 2、纠错等级 5。这里每条命令都是声明式的我告诉打印机在这个位置放这个元素具体怎么渲染由固件负责。参数顺序固定缺省可以用连续逗号跳过但跳错位置就容易出怪问题。3.3 EPL 版本的等价写法N q800 Q480,24 D15 R4 GW20,20,1,1,1200,40,点阵数据 A150,30,0,4,2,2,N,资产标签 A150,90,0,3,1,1,N,编号: A-2024-0001 B40,160,0,2,3,3,90,B,A-2024-0001 P1N清缓冲q设宽度Q480,24设长度和间隙24 点间隙D/R是浓度和速度GW写图形A写文字B写条码P1出纸。字体号 4 大概对应中等字号放大倍数用横向纵向两个数字控制。对比一下能看出关键差异EPL 没有 QR 命令上面这个例子刻意省略了 QR因为老固件大概率不支持图形要自己算点阵数据字体靠倍数放大整体表达力明显弱一档。3.4 逐项对照表迁移时照着查功能点ZPL 写法EPL 写法迁移注意标签开始^XAN清缓冲EPL 无严格开始符标签结束^XZP1打印EPL 靠打印指令收尾宽度设置^PW800q800单位都是点长度设置^LL480Q480,24EPL 需带间隙值文字^A0N,36,36^FD^FSA x,y,0,4,2,2,N,...字体号与倍数需重算一维码^BC/^B3/^BYB x,y,0,type,...码制编号不一样二维码^BQ多数老机型不支持需降级为图形图形^GF支持压缩GW原始点阵数据量差异大浓度^MD15D15数值范围可能不同速度^PR4R4档位含义需实测字符集^CI28UTF-8I命令能力有限中文场景优先 ZPL这张表建议直接贴到项目文档里迁移时一行行对比翻手册快得多。3.5 发送与调试的实操方式调试阶段我一般不走业务系统直接用命令行把模板推到打印机。Linux 下用nc或lp直发原始数据Windows 下用共享端口加原始打印方式。关键是绕开驱动的渲染层确保发过去的就是原始指令。# 把模板文件直接送到打印机的 9100 端口 cat label.zpl | nc 192.168.1.50 9100发送后观察出纸情况如果完全空白多半是没收到^XA或者语言模式不对如果只走纸不打印检查浓度是不是被设成 0如果内容错位先量实际出纸尺寸和设置值差多少再判断是分辨率还是原点问题。实操心得调试时在模板里故意放一个定位标记比如左上角打一个 5mm 的实心方块。出纸后量方块到纸边的距离就能立刻算出整体偏移量比盲猜坐标高效得多。这个习惯我保持了几年几乎每次换机器都能省下半小时。4. 从一种语言迁到另一种按这个路线走4.1 第一步永远是确认目标机器到底认什么别急着改模板先确认机器语言模式。方法有三种看驱动里有没有语言选项、发一条最简单的测试指令看反应、查固件版本和机型手册。最稳妥的是发测试指令给打印机发一段只有^XA^FO50,50^A0N,40,40^FDTEST^FS^XZ的内容能打出 TEST 说明吃 ZPL换成NA50,50,0,4,1,1,N,TESTP1能打出来说明吃 EPL。有些机器两种都认会自动识别首字符。这种情况反而要小心因为自动识别可能误判尤其是模板里混入了二进制图形数据时。4.2 建立映射关系别一条条硬翻译迁移的核心工作是把语义对上而不是把命令逐个替换。我的做法是先列一张元素清单文字几处、条码几个、图形几个、变量几处然后按元素类型批量转换。坐标转换要按分辨率比例算。假设原模板是 203 dpi目标是 300 dpi比例约 1.476所有 x、y、宽、高都乘这个系数再取整。条码的窄条宽度不能简单乘要按目标分辨率的可用档位重新选否则条码会变宽或者扫不出来。字号转换更麻烦。ZPL 的可缩放字体给的是点高EPL 给的是字体号加倍数两者没有精确对应关系。我的经验是先按点高除以一个基准值估算倍数打出来再微调通常试两三轮就能对上。4.3 分阶段验证别一次性全量切换第一阶段只迁静态元素文字和图形先跑通第二阶段加一维码验证扫描枪能读第三阶段加二维码和变量最后才接业务系统批量打。每个阶段都留一张实物样张做对照出问题能快速定位是哪一类元素。批量验证时至少打 50 张连续标签观察有没有累积偏移、有没有中间某张缺内容、有没有碳带起皱。单张打得好看不代表批量稳定走纸精度和回退一致性只有连续打才暴露得出来。4.4 双语言并存的写法建议如果短期内没法统一可以在业务系统里做一层模板适配同一份数据按目标机器类型渲染成 ZPL 或 EPL 两套模板。模板文件按元素定义 渲染器的方式组织元素定义里只写语义文字内容、坐标比例、条码类型渲染器负责翻译成具体指令。这样做的好处是新增机型时只加一个渲染器不用把所有模板重写一遍。代价是前期要多花两三天搭架子但只要有超过三种机型这笔投入很快就能回本。5. 常见问题与排查实录5.1 打印全空白或者只走纸这是最高频的问题。按顺序排查先确认语言模式对不对ZPL 模板发到只认 EPL 的机器上通常就是空白出纸再确认^XA和^XZ是否成对缺一个会导致整段被丢弃然后看浓度是不是 0 或者介质类型设错热敏模式打铜版纸出来的几乎是白纸最后检查宽度设置是否超出打印头范围超宽时部分固件会直接忽略整个格式。EPL 侧对应的问题是N之后没有P或者q/Q的值设成了 0。还有一种冷门情况模板开头有 BOM 或者不可见字符固件解析首字母失败整段被当垃圾丢掉。用十六进制工具看一眼文件头就能排除。5.2 内容整体偏移或者被截断偏移先量三个数实际出纸宽度、设置宽度、内容最右边缘位置。如果实际出纸比设置窄说明宽度参数没生效检查^PW或q是否在正确位置如果出纸正常但内容偏检查^LH、O这类原点偏移命令有没有残留旧值。截断通常是坐标系搞错了。ZPL 的^FO是字段左上角EPL 的A/B也是左上角但两者的原点定义在部分机型上有细微差别尤其是带切刀或者带剥离器的机型机械原点会偏移几个毫米。这种偏移只能靠实测补偿没有理论值可算。5.3 条码打得出来但扫不出来先看条码高度够不够一般建议不低于 10mm太矮的条码对扫描枪很不友好。再看窄条宽度203 dpi 下窄条至少 2 点再窄打印头分辨率跟不上边缘会糊。然后检查浓度浓度过高会让条码线条变粗相邻线条粘连浓度过低则边缘发虚对比度不够。还有一个容易忽略的点条码两侧的静区。ZPL 的^BC不会自动留白如果条码紧贴其他内容扫描枪可能识别失败。手动在左右各留 10 点以上的空白问题基本就解决了。5.4 中文和特殊字符打成乱码ZPL 打中文需要两个条件字体文件已下载到打印机模板里用^CI28之类的命令切到 UTF-8 编码并且^A命令引用的字体是支持中文的那一个。缺任何一条都会出乱码或者方块。EPL 侧对中文的支持更弱很多老固件只有单字节字符集中文基本无解只能把中文预渲染成图形打。这是 EPL 迁移到 ZPL 的一个强动力只要业务里有中文早晚要换。5.5 问题速查表现象优先排查常见原因全空白出纸语言模式、^XA/^XZ配对模板发错机器、格式不完整只走纸不打印浓度、介质类型浓度 0、热敏模式打铜版纸内容偏左/偏上原点偏移命令^LH残留、O值未清零右侧被截断宽度设置^PW或q小于实际内容宽条码扫不出高度、窄条宽、浓度、静区条码太矮、线条粘连、无留白中文乱码字体、编码命令字体未下载、编码未切换二维码位置空白固件二维支持EPL 固件不支持BQ类命令连续打印逐渐偏移走纸校准、间隙检测标签间隙参数与实际纸张不符6. 选型与落地我踩过之后总结的几条6.1 新项目直接上 ZPL别犹豫只要机器支持新项目没有理由选 EPL。ZPL 的表达能力、二维条码支持、Unicode 支持、模板管理能力都强一档而且固件更新还在持续遇到问题更容易找到资料。EPL 更像是为了兼容存量设备而存在的方案把它当主力语言用后期扩展会很受限。我经手的一个模拟项目最初为了省事沿用了老系统的 EPL 模板结果业务方提出要加二维码和中文品名两样都得绕路实现最后返工重写成 ZPL前后多花了将近两周。这个教训很直接语言选型要按未来一年的需求看不是按当下能不能跑通看。6.2 存量 EPL 设备评估清楚再决定换不换如果现场还有一批只认 EPL 的老机器先算一笔账这些机器还能用多久、每月打印量多少、标签复杂度会不会提升。如果只是打简单的物流面单继续用 EPL 完全没问题没必要为了统一而折腾。但如果标签要加二维码、要加中文、要做可变数据排版那就要认真考虑换机或者做双模板适配。双模板适配的成本主要在维护每次业务改版都要改两套模板测试也要测两遍。机器数量少的时候这个成本不明显超过十台就会变成负担。6.3 几条不太容易写进手册的经验第一条模板里永远显式写宽度和长度不要依赖打印机记忆的默认值。换机器、恢复出厂设置、固件升级都可能清掉默认值显式写死最省心。第二条坐标尽量用整数避免小数。部分固件对小数处理不一致203 dpi 下 0.5 点的差异看不出来300 dpi 下就可能累积成明显偏移。第三条模板文件保存时统一用无 BOM 的 UTF-8 或者纯 ASCII别用系统默认编码。我遇到过模板在开发机上正常、部署到另一台机器就空白的情况查到最后是文件头多了三个字节。第四条调试用的定位方块和测试文字正式上线前一定要删干净。曾经有一批标签左上角带着个黑方块发到现场被当成印刷缺陷投诉最后只能整批重打。第五条给每台机器记录一份实际参数表分辨率、有效打印宽度、原点偏移补偿值、浓度推荐档位。这些值靠猜是猜不准的量一次记下来后面换模板、换批次都能直接用省掉大量重复试打。 
长河君 · 2026/10/31 17:02:03 · 阅读 1.2k ZPL与EPL标签打印语言对比：语法差异、迁移适配与调试排查
1. 先把这两个方言的底细摸清楚1.1 出身不同决定了它们的写法天生不一样斑马打印机上跑的 ZPL 和 EPL本质上不是新旧两代的关系而是两条技术路线在同一个品牌下并存。ZPL 全称 Zebra Programming Language是斑马自家原生的标签描述语言从早期的工业机型一路演进到 ZPL II现在几乎所有在售机型都以它为主力。EPL 全称 Eltron Programming Language来自早年做桌面条码打印机的 Eltron 品牌那家厂商被收购之后这条产品线的指令集被保留了下来后来演化出 EPL2主要服务于桌面级小机器和存量老设备。这个出身差异带来的直接后果是ZPL 更像一套版面描述系统它假设你要排版、要放条码、要放图形、要放变量所以指令设计得比较完整一条命令带一堆参数EPL 更像逐行画图指令它假设标签结构简单、内容固定能用最少的字符把一张面单画出来就行。你如果只打过物流面单可能觉得两者差不多一旦要做带二维码、带可变数据、带中文字体的复杂标签差距立刻显出来。我在实际项目里遇到最多的情况是新采购的机器默认吃 ZPL但车间里那批用了七八年的桌面机只认 EPL两边共用一套业务系统就得同时维护两套模板。不理解它们的差异模板改一处崩一处排查起来非常痛苦。1.2 命令风格符号流与字母指令的正面碰撞ZPL 的指令几乎都以^或~开头后面跟一到两个字母再跟一串逗号分隔的参数。比如^FO100,100定位、^A0N,40,40选字体、^FD开始写数据、^FS结束这个字段。整套格式被^XA和^XZ包起来形成一个完整的标签格式。EPL 则干净利落得多命令基本都是单字母或双字母参数同样逗号分隔没有成对包裹的概念。N清空缓冲区A10,10,0,4,1,1,N写一行字B10,50,0,1,2,6,80,B打一个条码P1打印一张。你把命令一条条发过去打印机就一条条执行最后统一出纸。这个差异看起来只是写法问题实际影响很大。ZPL 的^XA...^XZ结构天然支持整块下发、整块取消中途出错可以直接丢弃整个格式EPL 是流式的一旦前半截已经进缓冲区后面出问题只能靠N清掉重来。做批量打印时ZPL 更容易做事务式控制。1.3 机型与固件支持是选语言的现实约束ZPL 的支持面非常广从桌面机到工业机基本全覆盖固件更新也比较勤新命令比如更完整的二维条码、Unicode 编码优先在 ZPL 上实现。EPL 的处境就比较尴尬它是为了兼容老设备而保留的新机型上通常以EPL 兼容模式的形式存在能跑常见命令但一些高级特性会缺。具体来说早期以 LP、TLP 开头的桌面系列很多只支持 EPL这类机器在仓储、门店、小工厂里还有大量存量。后来的 ZD、ZT、GX 系列以 ZPL 为主部分型号可以在驱动或固件里切换语言切过去之后 EPL 命令能认但不保证 100% 行为一致。注意所谓支持 EPL 兼容很多时候是固件里做了一层解释器把 EPL 命令翻译成内部格式。翻译层不可能覆盖全部命令尤其是图形下载、特殊字符集、状态查询这几块容易出现命令没报错但效果不对的情况。判断一台机器到底能不能稳定跑 EPL最靠谱的办法是拿真实模板实测别只看参数表。2. 核心语法逐项对照别只看表面2.1 标签结构一个成对包裹一个顺序执行ZPL 的骨架非常固定^XA ^PW812 ^LL1218 ^FO50,50^A0N,40,40^FDHello^FS ^FO50,120^BY3^BCN,100,Y,N,N^FD1234567890^FS ^XZ^XA开始^XZ结束中间每一条^FO...^FS是一个独立字段。^PW设打印宽度^LL设标签长度单位都是点dot。这种结构的好处是可以把整段存进打印机做模板^DF存、^XF调用也可以在主控端拼接变量后整段发送。EPL 没有这层包裹一段典型的标签是这样N q812 Q1218,24 A50,50,0,4,1,1,N,Hello B50,120,0,1,2,6,100,B,1234567890 P1N清缓冲区q设标签宽度Q设标签长度和间隙中间逐条画内容P1打印一张。这里没有结束符打印机收到P就认为这一批可以出纸了。所以 EPL 模板的边界是靠N和P划出来的一旦中间某条命令参数写错后面的内容可能整体错位。我个人的习惯是写 EPL 模板时第一条永远是N最后一条永远是P中间不夹任何空行和注释以外的内容避免固件解析时把换行当成异常。2.2 坐标与分辨率点阵原点是所有偏移问题的根源两种语言都用点作为默认单位但换算关系必须记牢203 dpi 的机器大约是 8 点/毫米300 dpi 大约是 11.8 点/毫米600 dpi 大约是 23.6 点/毫米。同一张 100mm 宽的标签在 203 dpi 机器上宽度约 800 点在 300 dpi 机器上约 1180 点模板里的坐标必须跟着变否则要么内容被截断要么缩在左上角一小块。ZPL 里控制原点和尺寸的主要是^LH标签 home 偏移、^LT标签偏移、^FO字段原点、^PW打印宽度、^LL标签长度。^FO的坐标是相对于标签左上角的但会受^LH影响。很多打出来整体偏左 5mm的问题最后查出来是^LH残留了一个旧值。EPL 里对应的是O原点偏移、q/Q宽度、A/B命令自带坐标。EPL 的坐标原点是打印头起点O命令可以把整体内容平移做机械误差补偿时很实用。实操心得换机器或换分辨率时别急着手改坐标。先在模板里把宽度、长度按新分辨率算一遍用比例缩放生成新坐标再人工微调。我吃过一次亏203 dpi 的模板直接丢到 300 dpi 机器上打条码高度不够扫不出来现场排查了半天才反应过来是分辨率差异。2.3 字体与文字排版可缩放与固定点阵的区别ZPL 的字体体系以^A命令为核心^A0N,高度,宽度调用可缩放字体后面的字母A、B、D、F、G、H 等对应内置字体集还能通过^CW加载外部字体。斜体、反白、旋转都在命令参数里控制排版自由度很高。EPL 的A命令参数是固定顺序A x,y,旋转,字体号,横向倍数,纵向倍数,反白,内容。字体号只有 1 到 5 这几种内置点阵字体字号靠横向、纵向倍数放大放大会出现明显的锯齿。想要平滑字体得靠外部字体下载或者干脆改用图形方式打印。这个差异直接决定了适用场景ZPL 适合做需要精细排版的标签比如带公司名、规格说明、多行文字的成品标签EPL 适合做信息为主、排版为辅的面单字号放大两倍能看清就行。2.4 条码与二维码ZPL 的原生优势区ZPL 的条码命令按类型分开^BC是 Code128^B3是 Code39^BQ是 QR 码^BX是 DataMatrix^BY统一设置窄条宽度、宽窄比和条码高度。参数虽多但语义清晰一维二维都能原生支持。EPL 的条码命令统一是B靠 type 参数区分码制常见的是 1 对应 Code39、2 对应 Code128、3 对应 UPC-A、5 对应 EAN13 等。二维条码在老版本 EPL 里支持很弱QR 码往往要依赖固件版本有的机器干脆不支持只能用图形方式把二维码当图片打。这是迁移时最容易踩的坑一张带 QR 码的标签从 ZPL 迁到 EPL如果目标机器固件不支持二维命令模板不会报错但二维码位置会空着。解决办法是把二维码预渲染成点阵图形用图形命令下载后打印代价是灵活性下降变量内容没法动态生成。2.5 图形与图像一个支持压缩流一个偏原始点阵ZPL 的^GF图形字段支持多种数据格式包括 ASCII 十六进制、原始二进制、以及带压缩的编码方式。压缩这一点很关键一张 800×600 点的黑白图未压缩数据量很大压缩后能降一个数量级传输和缓存压力都小很多。EPL 侧的图形处理相对原始通常是把点阵数据按行写入打印机内存再按名字或位置调用。数据量大时传输慢而且不同固件对图形缓存的容量限制不一样图稍微大一点就可能被截断。做 logo 打印时我的建议是能用 ZPL 就用 ZPL 的压缩图形非要用 EPL先把 logo 转成单色、去掉灰阶、裁掉空白边把数据量压到最小再考虑分块传输。2.6 打印参数浓度、速度、介质模式的设置位置ZPL 把这些放在格式内部^PR设速度^MD设浓度^MN设介质类型^JM设分辨率相关参数。优点是模板自带参数换机器不用重新配缺点是如果模板里的值和现场纸张不匹配出纸效果会莫名其妙。EPL 的D设浓度、R设速度通常放在模板开头和N、q、Q挨在一起。这些参数是全局生效的发一次之后会保持直到下次被覆盖。注意浓度参数对热敏纸和铜版纸的影响完全相反。热敏纸浓度调高容易发黑糊边铜版纸热转印浓度不够则条码边缘发虚、扫不出来。EPL 模板迁移到 ZPL 时浓度值不能直接照搬需要重新试打三档低、中、高再定。3. 拿一张真实标签两种语言各写一遍3.1 先把需求定义清楚假设要做一张 100mm × 60mm 的资产标签203 dpi 机器内容包括标题文字一行、资产编号一行、Code128 条码一个、右下角一个 QR 码、左上角一个小 logo。宽度换算成点约 800长度约 480。这个需求覆盖了文字、一维码、二维码、图形四类元素正好能体现两种语言的差异。3.2 ZPL 版本的写法与逐行解释^XA ^PW800 ^LL480 ^PR4 ^MD15 ^LH0,0 ^FO20,20^GFA,1200,1200,40,...^FS ^FO150,30^A0N,36,36^FD资产标签^FS ^FO150,90^A0N,28,28^FD编号: A-2024-0001^FS ^FO40,160^BY3^BCN,90,Y,N,N^FDA-2024-0001^FS ^FO600,300^BQN,2,5^FDQA,A-2024-0001^FS ^XZ^PW800和^LL480定义画布^PR4是速度档^MD15是浓度。^FO定位每个字段^A0N,36,36是高度宽度都为 36 点的可缩放字体^BCN,90,Y,N,N表示 Code128、条码高 90 点、打印可读字符、字符在条码下方。^BQN,2,5是 QR 码模型 2、纠错等级 5。这里每条命令都是声明式的我告诉打印机在这个位置放这个元素具体怎么渲染由固件负责。参数顺序固定缺省可以用连续逗号跳过但跳错位置就容易出怪问题。3.3 EPL 版本的等价写法N q800 Q480,24 D15 R4 GW20,20,1,1,1200,40,点阵数据 A150,30,0,4,2,2,N,资产标签 A150,90,0,3,1,1,N,编号: A-2024-0001 B40,160,0,2,3,3,90,B,A-2024-0001 P1N清缓冲q设宽度Q480,24设长度和间隙24 点间隙D/R是浓度和速度GW写图形A写文字B写条码P1出纸。字体号 4 大概对应中等字号放大倍数用横向纵向两个数字控制。对比一下能看出关键差异EPL 没有 QR 命令上面这个例子刻意省略了 QR因为老固件大概率不支持图形要自己算点阵数据字体靠倍数放大整体表达力明显弱一档。3.4 逐项对照表迁移时照着查功能点ZPL 写法EPL 写法迁移注意标签开始^XAN清缓冲EPL 无严格开始符标签结束^XZP1打印EPL 靠打印指令收尾宽度设置^PW800q800单位都是点长度设置^LL480Q480,24EPL 需带间隙值文字^A0N,36,36^FD^FSA x,y,0,4,2,2,N,...字体号与倍数需重算一维码^BC/^B3/^BYB x,y,0,type,...码制编号不一样二维码^BQ多数老机型不支持需降级为图形图形^GF支持压缩GW原始点阵数据量差异大浓度^MD15D15数值范围可能不同速度^PR4R4档位含义需实测字符集^CI28UTF-8I命令能力有限中文场景优先 ZPL这张表建议直接贴到项目文档里迁移时一行行对比翻手册快得多。3.5 发送与调试的实操方式调试阶段我一般不走业务系统直接用命令行把模板推到打印机。Linux 下用nc或lp直发原始数据Windows 下用共享端口加原始打印方式。关键是绕开驱动的渲染层确保发过去的就是原始指令。# 把模板文件直接送到打印机的 9100 端口 cat label.zpl | nc 192.168.1.50 9100发送后观察出纸情况如果完全空白多半是没收到^XA或者语言模式不对如果只走纸不打印检查浓度是不是被设成 0如果内容错位先量实际出纸尺寸和设置值差多少再判断是分辨率还是原点问题。实操心得调试时在模板里故意放一个定位标记比如左上角打一个 5mm 的实心方块。出纸后量方块到纸边的距离就能立刻算出整体偏移量比盲猜坐标高效得多。这个习惯我保持了几年几乎每次换机器都能省下半小时。4. 从一种语言迁到另一种按这个路线走4.1 第一步永远是确认目标机器到底认什么别急着改模板先确认机器语言模式。方法有三种看驱动里有没有语言选项、发一条最简单的测试指令看反应、查固件版本和机型手册。最稳妥的是发测试指令给打印机发一段只有^XA^FO50,50^A0N,40,40^FDTEST^FS^XZ的内容能打出 TEST 说明吃 ZPL换成NA50,50,0,4,1,1,N,TESTP1能打出来说明吃 EPL。有些机器两种都认会自动识别首字符。这种情况反而要小心因为自动识别可能误判尤其是模板里混入了二进制图形数据时。4.2 建立映射关系别一条条硬翻译迁移的核心工作是把语义对上而不是把命令逐个替换。我的做法是先列一张元素清单文字几处、条码几个、图形几个、变量几处然后按元素类型批量转换。坐标转换要按分辨率比例算。假设原模板是 203 dpi目标是 300 dpi比例约 1.476所有 x、y、宽、高都乘这个系数再取整。条码的窄条宽度不能简单乘要按目标分辨率的可用档位重新选否则条码会变宽或者扫不出来。字号转换更麻烦。ZPL 的可缩放字体给的是点高EPL 给的是字体号加倍数两者没有精确对应关系。我的经验是先按点高除以一个基准值估算倍数打出来再微调通常试两三轮就能对上。4.3 分阶段验证别一次性全量切换第一阶段只迁静态元素文字和图形先跑通第二阶段加一维码验证扫描枪能读第三阶段加二维码和变量最后才接业务系统批量打。每个阶段都留一张实物样张做对照出问题能快速定位是哪一类元素。批量验证时至少打 50 张连续标签观察有没有累积偏移、有没有中间某张缺内容、有没有碳带起皱。单张打得好看不代表批量稳定走纸精度和回退一致性只有连续打才暴露得出来。4.4 双语言并存的写法建议如果短期内没法统一可以在业务系统里做一层模板适配同一份数据按目标机器类型渲染成 ZPL 或 EPL 两套模板。模板文件按元素定义 渲染器的方式组织元素定义里只写语义文字内容、坐标比例、条码类型渲染器负责翻译成具体指令。这样做的好处是新增机型时只加一个渲染器不用把所有模板重写一遍。代价是前期要多花两三天搭架子但只要有超过三种机型这笔投入很快就能回本。5. 常见问题与排查实录5.1 打印全空白或者只走纸这是最高频的问题。按顺序排查先确认语言模式对不对ZPL 模板发到只认 EPL 的机器上通常就是空白出纸再确认^XA和^XZ是否成对缺一个会导致整段被丢弃然后看浓度是不是 0 或者介质类型设错热敏模式打铜版纸出来的几乎是白纸最后检查宽度设置是否超出打印头范围超宽时部分固件会直接忽略整个格式。EPL 侧对应的问题是N之后没有P或者q/Q的值设成了 0。还有一种冷门情况模板开头有 BOM 或者不可见字符固件解析首字母失败整段被当垃圾丢掉。用十六进制工具看一眼文件头就能排除。5.2 内容整体偏移或者被截断偏移先量三个数实际出纸宽度、设置宽度、内容最右边缘位置。如果实际出纸比设置窄说明宽度参数没生效检查^PW或q是否在正确位置如果出纸正常但内容偏检查^LH、O这类原点偏移命令有没有残留旧值。截断通常是坐标系搞错了。ZPL 的^FO是字段左上角EPL 的A/B也是左上角但两者的原点定义在部分机型上有细微差别尤其是带切刀或者带剥离器的机型机械原点会偏移几个毫米。这种偏移只能靠实测补偿没有理论值可算。5.3 条码打得出来但扫不出来先看条码高度够不够一般建议不低于 10mm太矮的条码对扫描枪很不友好。再看窄条宽度203 dpi 下窄条至少 2 点再窄打印头分辨率跟不上边缘会糊。然后检查浓度浓度过高会让条码线条变粗相邻线条粘连浓度过低则边缘发虚对比度不够。还有一个容易忽略的点条码两侧的静区。ZPL 的^BC不会自动留白如果条码紧贴其他内容扫描枪可能识别失败。手动在左右各留 10 点以上的空白问题基本就解决了。5.4 中文和特殊字符打成乱码ZPL 打中文需要两个条件字体文件已下载到打印机模板里用^CI28之类的命令切到 UTF-8 编码并且^A命令引用的字体是支持中文的那一个。缺任何一条都会出乱码或者方块。EPL 侧对中文的支持更弱很多老固件只有单字节字符集中文基本无解只能把中文预渲染成图形打。这是 EPL 迁移到 ZPL 的一个强动力只要业务里有中文早晚要换。5.5 问题速查表现象优先排查常见原因全空白出纸语言模式、^XA/^XZ配对模板发错机器、格式不完整只走纸不打印浓度、介质类型浓度 0、热敏模式打铜版纸内容偏左/偏上原点偏移命令^LH残留、O值未清零右侧被截断宽度设置^PW或q小于实际内容宽条码扫不出高度、窄条宽、浓度、静区条码太矮、线条粘连、无留白中文乱码字体、编码命令字体未下载、编码未切换二维码位置空白固件二维支持EPL 固件不支持BQ类命令连续打印逐渐偏移走纸校准、间隙检测标签间隙参数与实际纸张不符6. 选型与落地我踩过之后总结的几条6.1 新项目直接上 ZPL别犹豫只要机器支持新项目没有理由选 EPL。ZPL 的表达能力、二维条码支持、Unicode 支持、模板管理能力都强一档而且固件更新还在持续遇到问题更容易找到资料。EPL 更像是为了兼容存量设备而存在的方案把它当主力语言用后期扩展会很受限。我经手的一个模拟项目最初为了省事沿用了老系统的 EPL 模板结果业务方提出要加二维码和中文品名两样都得绕路实现最后返工重写成 ZPL前后多花了将近两周。这个教训很直接语言选型要按未来一年的需求看不是按当下能不能跑通看。6.2 存量 EPL 设备评估清楚再决定换不换如果现场还有一批只认 EPL 的老机器先算一笔账这些机器还能用多久、每月打印量多少、标签复杂度会不会提升。如果只是打简单的物流面单继续用 EPL 完全没问题没必要为了统一而折腾。但如果标签要加二维码、要加中文、要做可变数据排版那就要认真考虑换机或者做双模板适配。双模板适配的成本主要在维护每次业务改版都要改两套模板测试也要测两遍。机器数量少的时候这个成本不明显超过十台就会变成负担。6.3 几条不太容易写进手册的经验第一条模板里永远显式写宽度和长度不要依赖打印机记忆的默认值。换机器、恢复出厂设置、固件升级都可能清掉默认值显式写死最省心。第二条坐标尽量用整数避免小数。部分固件对小数处理不一致203 dpi 下 0.5 点的差异看不出来300 dpi 下就可能累积成明显偏移。第三条模板文件保存时统一用无 BOM 的 UTF-8 或者纯 ASCII别用系统默认编码。我遇到过模板在开发机上正常、部署到另一台机器就空白的情况查到最后是文件头多了三个字节。第四条调试用的定位方块和测试文字正式上线前一定要删干净。曾经有一批标签左上角带着个黑方块发到现场被当成印刷缺陷投诉最后只能整批重打。第五条给每台机器记录一份实际参数表分辨率、有效打印宽度、原点偏移补偿值、浓度推荐档位。这些值靠猜是猜不准的量一次记下来后面换模板、换批次都能直接用省掉大量重复试打。