快捷導(dǎo)航

使用Python+ZPL實現(xiàn)標簽打印與中文排版

更新時間：2026年02月03日 08:51:38 作者：GAMC

這篇文章主要介紹了如何使用Python和ZPL（斑馬打印機腳本語言）來解決標簽打印問題,通過將內(nèi)容先在Python中渲染成圖片,然后轉(zhuǎn)換成ZPL指令,實現(xiàn)了所見即所得、支持任意字體和無需配置打印機等優(yōu)勢,需要的朋友可以參考下

1. 什么是 ZPL？

ZPL 是斑馬公司為標簽打印機開發(fā)的一套腳本語言。你可以把它想象成打印機界的“HTML”。通過發(fā)送一串類似 ^XA^FO50,50^A0N,50,50^FDHello World^FS^XZ 的指令，打印機就能在指定位置打印出文字。

2. 我們的秘密武器：降維打擊

為了繞過 ZPL 繁瑣的字體配置，我們采用了一種“降維打擊”的策略：將所有內(nèi)容（文字、條碼、二維碼）先在 Python 中渲染成一張圖片，然后將圖片轉(zhuǎn)換成 ZPL 指令發(fā)給打印機。

這種方案的專業(yè)術(shù)語叫 “文本轉(zhuǎn)位圖”。

核心優(yōu)勢：

所見即所得：你在屏幕上看到的字體、間距，打印出來完全一致。
支持任意字體：只要你電腦里有的字體（微軟雅黑、阿里巴巴普惠體等），統(tǒng)統(tǒng)都能打印。
無需配置打印機：不需要去折騰打印機的內(nèi)存和字體文件，插上就能打。

3. 技術(shù)實現(xiàn)拆解

第一步：使用 Pillow 繪制“標簽照”

我們利用 Python 的 Pillow 庫，根據(jù)業(yè)務(wù)數(shù)據(jù)創(chuàng)建一個空白畫布，然后在上面畫圖。

from PIL import Image, ImageDraw, ImageFont

# 創(chuàng)建一個 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)

第二步：將圖片轉(zhuǎn)換為 ZPL 十六進制數(shù)據(jù)

ZPL 提供了一個 ^GFA 指令，允許我們發(fā)送原始的圖像字節(jié)數(shù)據(jù)。我們將 Pillow 處理好的黑白像素點，轉(zhuǎn)換成打印機能聽懂的十六進制字符串。

在本項目中，src/zpl_utils.py 負責(zé)這項繁瑣的轉(zhuǎn)換工作，確保每一行像素都能精準對應(yīng)。

第三步：發(fā)送 RAW 數(shù)據(jù)到打印機

Windows 的普通打印驅(qū)動通常會經(jīng)過圖形層處理，速度較慢。為了追求極致響應(yīng)，我們通過 pywin32 庫直接向打印機發(fā)送 RAW（原始） 數(shù)據(jù)。

import win32print

def send_to_printer(printer_name, zpl_data):
    hPrinter = win32print.OpenPrinter(printer_name)
    try:
        # 開啟打印作業(yè)，指定類型為 "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 指令速查

在本項目中，我們雖然主要依賴圖像傳輸，但仍需一些基礎(chǔ)指令來定義標簽。以下是核心指令說明：

指令	說明	作用
^XA	標簽開始	告訴打印機：這是一張新標簽的起點。
^XZ	標簽結(jié)束	告訴打印機：指令發(fā)送完畢，可以開始打印/出紙了。
^PW	打印寬度	設(shè)置標簽的寬度（以點 dots 為單位），防止內(nèi)容被截斷。
^LL	標簽長度	設(shè)置標簽的高度，決定了打印機走紙的距離。
^LH	標簽原點	設(shè)置打印的起始坐標 (0,0) 的物理位置。
^MD	打印濃度	設(shè)置打印深度（0-30），覺得顏色不夠黑？調(diào)它。
^FO	字段坐標	Field Origin，定義元素在標簽上的 X,Y 軸位置。
^FS	字段分隔符	Field Separator，每個元素指令后的“句號”，必不可少。
^GFA	圖形 ASCII	本方案的核心。它負責(zé)將我們轉(zhuǎn)換好的十六進制圖像數(shù)據(jù)“畫”到標簽上。