我最近刚搞定用ZPL打印机把PNG转成标签打印的需求，过程里踩了不少坑，分享下我的经验——我是先把PNG转成单色图像，再生成带图像数据的ZPL代码，而且在Labelary上预览完全正常，逻辑主要参考了《How to optimize ASCII HEX for BMP to ZPL as using in Labelary》这篇内容。

一、PNG转单色图像的核心要点 #

• 必须确保转换后的图像是纯黑白（1-bit），不能用灰度图——很多人这里踩坑，ZPL对单色图像的解析是基于像素点的0/1（黑/白），灰度图会导致打印出来糊成一团。
• 转换时要注意图像尺寸和打印机DPI匹配：比如常见的ZPL打印机是203DPI或300DPI，计算好标签上的实际尺寸对应的像素数，避免拉伸或压缩变形。举个例子，203DPI下1英寸对应203像素，如果你要打印2英寸宽的图像，就把图像宽度设为406像素。
• 用Python的PIL/Pillow处理的话，核心代码大概是这样：

from PIL import Image

# 打开PNG并转换为1-bit单色图像
img = Image.open("target_image.png").convert("1")
# 根据打印机DPI调整尺寸，这里以203DPI、2英寸宽1英寸高为例
target_width = 2 * 203
target_height = 1 * 203
img = img.resize((target_width, target_height), Image.Resampling.LANCZOS)

二、生成ZPL图像代码的关键细节 #

ZPL里用^GF指令嵌入图像数据，这里要注意几个优化点（就是参考文章里提到的ASCII HEX优化）：

• 把单色图像的像素按字节打包：每8个横向像素组成一个字节（从左到右，从上到下），然后转成十六进制字符串。如果像素数不是8的倍数，最后一个字节用0补位。
• 一定要启用Z64压缩：^GF的第三个参数设为Y，能大幅减少ZPL代码长度，避免打印机内存溢出。
• 标准的ZPL图像指令结构大概是这样：

^XA
^LL300          # 设置标签长度（单位：点）
^PW406          # 设置标签宽度（单位：点）
^FO20,20^GF,Y,{总字节数},{总字节数},{每行字节数},{压缩后的十六进制数据}^FS
^XZ

这里的参数必须准确对应：{总字节数}是整个图像的字节总数，{每行字节数}是单一行像素对应的字节数（比如宽度406像素，406÷8向上取整=51字节）。

三、Labelary预览正常但实际打印异常的常见坑 #

虽然Labelary上显示没问题，但实际打印可能出状况，我遇到过这几个典型问题：

• 打印机DPI不匹配：Labelary默认可能用203DPI，但你的实际打印机是300DPI，导致图像尺寸、位置偏差。解决办法是在ZPL开头用^LL和^PW指定和打印机匹配的标签尺寸，或者转换图像时就按实际打印机DPI计算像素数。
• 图像字节顺序错误：有些工具转换像素时是从右到左或从下到上读取，导致打印出来的图像反转。可以在转换后对图像做水平/垂直翻转测试，调整读取顺序。
• 打印机内存不足：如果图像太大，即使压缩后也可能超出打印机内存上限，这时候可以把图像分割成多个区域打印，或者适当降低图像分辨率。
• ZPL指令语法错误：比如^GF的参数写错（比如总字节数计算错误），Labelary可能有容错机制，但实际打印机严格校验，会直接跳过图像打印。这时候要仔细核对每个参数的数值。

内容的提问来源于stack exchange，提问作者Lenquist