一、什么是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,0

2、位置控制

指令 含义 参数
^FO 字段起始位置 x,y
^FT 字段位置(基线) x,y
^FB 文本块布局 width(文本宽度),lines(最大行数),spacing(行间距),align(对齐方式)

对齐方式L:左对齐;R:右对齐;C:居中;J:宽度一致

示例:

^FO100,200

3、文字打印

指令 含义 参数
^A 设置字体 字体,字体旋转,字体高度,字体宽度
^FD 字段数据
^FS 字段结束

字体旋转:N:正常; R:90° I:180° B:270°

示例:

^FO100,100
^A0N,40,40
^FDOrder:123456^FS

4、条形码指令

Code128 条码

指令 含义 参数
^BC Code128 条码 方向,条码高度,显示文字,不校验
^BY 条码宽度设置 线宽,宽窄比例,高度
^B3 Code39 条码

示例:

^BY3
^FO100,200
^BCN,120,Y,N
^FD1234567890^FS

PS:条形码无法使用居中对齐,只能够通过文字算出对应居中位置,目前已抽取公共方法请详见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