一、什么是ZPL指令码
ZPL 指令码是 Zebra Programming Language 的简称,是 Zebra Technologies 为自己的标签打印机设计的一种 打印控制语言。它主要用于 控制标签打印机打印条码、二维码、文字、图形等内容,在物流、仓储、快递面单等场景非常常见。
ZPL打印文件展示:
二、ZPL指令码优点
1️⃣ 直接控制打印机(速度快)
2️⃣ 无需图片渲染
3️⃣ 适合高并发打印(物流、仓库)
4️⃣ 支持条码/二维码/图形
三、常用ZPL指令及说明
1、标签控制指令
| 指令 | 含义 | 参数说明 | 示例 |
|---|---|---|---|
^XA |
开始标签 | 无 | ^XA |
^XZ |
结束标签 | 无 | ^XZ |
^PW |
标签宽度 | dots | ^PW800 |
^LL |
标签长度 | dots | ^LL1200 |
^LH |
标签原点 | x,y | ^LH0,0 |
^LS |
左边距 | dots | ^LS10 |
示例:
^XA
^PW800
^LL1200
^LH0,02、位置控制
| 指令 | 含义 | 参数 |
|---|---|---|
^FO |
字段起始位置 | x,y |
^FT |
字段位置(基线) | x,y |
^FB |
文本块布局 | width(文本宽度),lines(最大行数),spacing(行间距),align(对齐方式) |
对齐方式L:左对齐;R:右对齐;C:居中;J:宽度一致
示例:
^FO100,2003、文字打印
| 指令 | 含义 | 参数 |
|---|---|---|
^A |
设置字体 | 字体,字体旋转,字体高度,字体宽度 |
^FD |
字段数据 | |
^FS |
字段结束 |
字体旋转:N:正常; R:90° I:180° B:270°
示例:
^FO100,100
^A0N,40,40
^FDOrder:123456^FS4、条形码指令
Code128 条码
| 指令 | 含义 | 参数 |
|---|---|---|
| ^BC | Code128 条码 | 方向,条码高度,显示文字,不校验 |
| ^BY | 条码宽度设置 | 线宽,宽窄比例,高度 |
| ^B3 | Code39 条码 |
示例:
^BY3
^FO100,200
^BCN,120,Y,N
^FD1234567890^FSPS:条形码无法使用居中对齐,只能够通过文字算出对应居中位置,目前已抽取公共方法请详见DMS中的ZplLayoutUtil.java
5、二维码
| 指令 | 含义 | 参数 |
|---|---|---|
| ^BQN | 二维码 | 模型,大小 |
| ^FDQA | 条形码内容 |
示例:
^FO400,500^BQN,2,14^FDQA,DEMO260306001DEMO^FS四、ZPL调试
1.ZPL调试网站
https://labelary.com/viewer.html
2.调试样例
^XA
^FX Top section with logo, name and address.
^CF0,60
^FO50,50^GB100,100,100^FS
^FO75,75^FR^GB100,100,100^FS
^FO93,93^GB40,40,40^FS
^FO220,50^FDIntershipping, Inc.^FS
^CF0,30
^FO220,115^FD1000 Shipping Lane^FS
^FO220,155^FDShelbyville TN 38102^FS
^FO220,195^FDUnited States (USA)^FS
^FO50,250^GB700,3,3^FS
^FX Second section with recipient address and permit information.
^CFA,30
^FO50,300^FDJohn Doe^FS
^FO50,340^FD100 Main Street^FS
^FO50,380^FDSpringfield TN 39021^FS
^FO50,420^FDUnited States (USA)^FS
^CFA,15
^FO600,300^GB150,150,3^FS
^FO638,340^FDPermit^FS
^FO638,390^FD123456^FS
^FO50,500^GB700,3,3^FS
^FX Third section with bar code.
^BY5,2,270
^FO100,550^BC^FD12345678^FS
^FX Fourth section (the two boxes on the bottom).
^FO50,900^GB700,250,3^FS
^FO400,900^GB3,250,3^FS
^CF0,40
^FO100,960^FDCtr. X34B-1^FS
^FO100,1010^FDREF1 F00B47^FS
^FO100,1060^FDREF2 BL4H8^FS
^CF0,190
^FO470,955^FDCA^FS
^XZ作者:陈杨 创建时间:2026-03-13 14:49
最后编辑:陈杨 更新时间:2026-04-17 09:34
最后编辑:陈杨 更新时间:2026-04-17 09:34