使用Python+ZPL实现标签打印与中文排版_Python

分享一下在本项目中，我们是如何利用 python 优雅地解决 zpl 打印。

1. 什么是 zpl？

zpl 是斑马公司为标签打印机开发的一套脚本语言。你可以把它想象成打印机界的“html”。通过发送一串类似 ^xa^fo50,50^a0n,50,50^fdhello world^fs^xz 的指令，打印机就能在指定位置打印出文字。

2. 我们的秘密武器：降维打击

为了绕过 zpl 繁琐的字体配置，我们采用了一种“降维打击”的策略：将所有内容（文字、条码、二维码）先在 python 中渲染成一张图片，然后将图片转换成 zpl 指令发给打印机。

这种方案的专业术语叫 “文本转位图”。

核心优势：

所见即所得：你在屏幕上看到的字体、间距，打印出来完全一致。
支持任意字体：只要你电脑里有的字体（微软雅黑、阿里巴巴普惠体等），统统都能打印。
无需配置打印机：不需要去折腾打印机的内存和字体文件，插上就能打。

3. 技术实现拆解

第一步：使用 pillow 绘制“标签照”

我们利用 python 的 pillow 库，根据业务数据创建一个空白画布，然后在上面画图。

from pil import image, imagedraw, imagefont

# 创建一个 203 dpi 的小画布 (约 40mm x 30mm)
width, height = 320, 240
img = image.new('1', (width, height), 1) # '1' 表示二值图（黑白）
draw = imagedraw.draw(img)

# 加载心仪的字体
font = imagefont.truetype("msyh.ttc", 24) # 微软雅黑
draw.text((20, 20), "智能标签助手", font=font, fill=0)

第二步：将图片转换为 zpl 十六进制数据

zpl 提供了一个 ^gfa 指令，允许我们发送原始的图像字节数据。我们将 pillow 处理好的黑白像素点，转换成打印机能听懂的十六进制字符串。

在本项目中，src/zpl_utils.py 负责这项繁琐的转换工作，确保每一行像素都能精准对应。

第三步：发送 raw 数据到打印机

windows 的普通打印驱动通常会经过图形层处理，速度较慢。为了追求极致响应，我们通过 pywin32 库直接向打印机发送 raw（原始） 数据。

import win32print

def send_to_printer(printer_name, zpl_data):
    hprinter = win32print.openprinter(printer_name)
    try:
        # 开启打印作业，指定类型为 "raw"
        hjob = win32print.startdocprinter(hprinter, 1, ("label job", none, "raw"))
        win32print.startpageprinter(hprinter)
        win32print.writeprinter(hprinter, zpl_data.encode('utf-8'))
        win32print.endpageprinter(hprinter)
        win32print.enddocprinter(hprinter)
    finally:
        win32print.closeprinter(hprinter)

4. 必备 zpl 指令速查

在本项目中，我们虽然主要依赖图像传输，但仍需一些基础指令来定义标签。以下是核心指令说明：

指令	说明	作用
^xa	标签开始	告诉打印机：这是一张新标签的起点。
^xz	标签结束	告诉打印机：指令发送完毕，可以开始打印/出纸了。
^pw	打印宽度	设置标签的宽度（以点 dots 为单位），防止内容被截断。
^ll	标签长度	设置标签的高度，决定了打印机走纸的距离。
^lh	标签原点	设置打印的起始坐标 (0,0) 的物理位置。
^md	打印浓度	设置打印深度（0-30），觉得颜色不够黑？调它。
^fo	字段坐标	field origin，定义元素在标签上的 x,y 轴位置。
^fs	字段分隔符	field separator，每个元素指令后的“句号”，必不可少。
^gfa	图形 ascii	本方案的核心。它负责将我们转换好的十六进制图像数据“画”到标签上。