Python调用打印机技术全景指南
在现代办公自动化、工业控制与物联网系统中,Python调用打印机已成为实现文档输出、标签打印、票据生成等场景的核心能力。随着Python生态的持续发展,各类跨平台打印库与接口日益成熟,开发者可基于不同操作系统、打印机类型及业务需求,选择最适配的技术方案。本页面系统梳理了Python调用打印机的全部主流路径,涵盖Windows平台的Win32打印API封装、Linux/Unix系统的CUPS接口调用、基于标准协议的IPP与SMB网络打印、蓝牙热敏打印机通信、条码与二维码专用打印机控制,以及常见问题的深度解答与实战代码示例,总字数逾3500字,内容覆盖从基础原理到高阶调优的完整知识链。
为何选择Python实现打印机控制?
- • 跨平台兼容性:通过统一接口适配不同操作系统,避免重复开发;
- • 生态丰富:如win32print、pycups、ipp、escpos等成熟库支持;
- • 开发效率高:语法简洁,调试便捷,支持快速原型验证;
- • 集成能力强:可无缝对接Web、数据库、AI模型输出等下游系统;
- • 开源活跃:社区持续更新,问题响应迅速,文档完备。
打印机控制的核心技术路径
从系统底层视角看,Python调用打印机本质上是向打印机设备发送符合其协议规范的数据流,具体路径可分为:
- • 直接设备访问:通过操作系统提供的设备文件(如/dev/usb/lp0)或Win32 API写入原始指令;
- • 打印服务调用:利用CUPS(Linux)、Windows Print Spooler等服务提交打印任务;
- • 网络协议通信:通过IPP(Internet Printing Protocol)、SMB/CIFS、HTTP等方式远程控制;
- • 串口/蓝牙通信:对串口连接或蓝牙打印机发送ESC/POS、CPCL、EPL等指令集。
实际开发中,应优先选择封装良好的库(如pycups、escpos),避免直接操作底层接口导致移植性差与安全风险。
Windows平台:Win32 API与Print Spooler集成
Windows系统通过Print Spooler服务管理所有打印任务,Python调用打印机最稳定的方式是调用Win32 API。需借助pywin32库实现,其核心流程为:打开打印队列 → 创建文档 → 写入数据 → 关闭文档 → 提交任务。
基础文档打印(文本/图片)
使用win32print与win32ui模块,实现标准文本与位图打印:
import win32print
import win32ui
import win32con
def print_text(text):
# 获取默认打印机
printer_name = win32print.GetDefaultPrinter()
hPrinter = win32print.OpenPrinter(printer_name)
# 创建文档
hDC = win32ui.CreateDC()
hDC.CreatePrinterDC(printer_name)
hDC.StartDoc('Python Print Job')
hDC.StartPage()
# 绘制文本
hDC.TextOut(100, 100, text)
hDC.EndPage()
hDC.EndDoc()
hDC.DeleteDC()
win32print.ClosePrinter(hPrinter)
此方案适用于纯文本、简单图形输出,但不支持PDF直接打印。对PDF需先渲染为图像或使用PyPDF2转换为GDI指令。
原始指令打印(ESC/POS等)
对条码打印机、热敏打印机,需发送原始字节流:
def print_raw_data(data_bytes):
printer_name = win32print.GetDefaultPrinter()
hPrinter = win32print.OpenPrinter(printer_name)
# 开始原始数据打印
win32print.StartDocPrinter(hPrinter, 1, ('Raw Print', None, '*RAW'))
win32print.StartPagePrinter(hPrinter)
win32print.WritePrinter(hPrinter, data_bytes)
win32print.EndPagePrinter(hPrinter)
win32print.EndDocPrinter(hPrinter)
win32print.ClosePrinter(hPrinter)
示例:打印二维码(需打印机支持GS(k指令)):
import struct
def generate_qr_code(data):
# 构造ESC/POS二维码指令
# GS ( k m H L n D1...Dn
# m=49, n=二维码数据长度
data_bytes = b'\\x1D\\x28\\x6B\\x30\\x30\\x31' + struct.pack('
实际调用:print_raw_data(generate_qr_code('https://www.xservx.com'))
PDF文档打印(推荐方案)
通过PyMuPDF(fitz)渲染PDF为图像后打印,或调用系统默认PDF阅读器后台打印:
import fitz # PyMuPDF
import tempfile
import subprocess
def print_pdf(pdf_path):
# 使用系统默认PDF阅读器后台打印
# 需设置注册表默认打印机
subprocess.run([
'rundll32', 'url.dll,FileProtocolHandler',
f'file://{pdf_path}'
], shell=True, check=False)
更可靠方案:使用Adobe Acrobat的命令行参数(需安装):
subprocess.run([
'C:\\Program Files\\Adobe\\Acrobat DC\\Acrobat\\Acrobat.exe',
'/t', pdf_path
])
注意:需确保 Acrobat 设置为静默打印(关闭打印对话框),否则会阻塞。
常见问题排查
- • 权限不足:以管理员身份运行脚本,或配置服务账号打印权限;
- • 中文乱码:使用Unicode编码(UTF-16 LE BOM)并确保打印机支持Unicode;
- • 卡纸/打印空白:检查打印机状态(空闲/忙碌)、纸张尺寸设置、驱动版本;
- • 多任务冲突:使用线程锁(threading.Lock)确保单次打印任务独占。
Linux/Unix平台:CUPS打印服务调用
Linux系统普遍采用CUPS(Common Unix Printing System)作为打印后端,Python调用打印机可通过pycups库与CUPS守护进程通信。CUPS支持IPP(Internet Printing Protocol)协议,可实现本地与网络打印机统一管理。
标准文档打印
支持PDF、PostScript、文本等格式:
import cups
conn = cups.Connection()
printers = conn.getPrinters()
default_printer = conn.getDefault()
# 打印PDF文件
conn.printFile(default_printer, '/path/to/document.pdf', 'Job Title', {})
关键参数说明:printFile的第三个参数为任务标题,第四个参数为打印选项字典(如份数、页面范围)。
原始指令打印(ESC/POS)
通过Raw Queue实现,需在CUPS中创建Raw类型打印机:
# 在终端执行(需管理员权限)
lpadmin -p RawPrinter -E -v parallel:/dev/lp0 -m raw
# Python调用
conn.printFile('RawPrinter', '/tmp/data.bin', 'Raw Job', {'raw': 'true'})
注意:Raw Queue不处理格式转换,直接发送原始字节流,需确保打印机支持对应指令集。
查询与管理打印任务
获取当前打印队列状态:
jobs = conn.getJobs()
for job_id, job in jobs.items():
print(f'任务ID: {job_id}, 状态: {job["job-state"]}, 标题: {job["job-name"]}')
取消任务:conn.cancelJob(job_id)
设置默认打印机:conn.setDefault(default_printer)
/etc/cups/cupsd.conf(服务配置)、/etc/cups/printers.conf(打印机定义)。修改后需重启cupsd服务:sudo systemctl restart cups
CUPS与网络打印机集成
通过IPP协议直接控制网络打印机(如HP JetDirect设备):
import cups
conn = cups.Connection()
# 直接连接网络打印机IP(需开启IPP服务)
ipp_uri = 'ipp://192.168.1.100/ipp/print'
conn.addPrinter(name='NetworkPrinter', device=ipp_uri, model='raw')
# 打印测试页
conn.printFile('NetworkPrinter', '/etc/cups/testpage.ps', 'Test', {})
适用场景:打印机无驱动支持、需跨平台统一管理、批量部署环境。
网络打印机:IPP与SMB协议调用
现代打印机普遍支持网络连接,Python调用打印机可通过标准网络协议实现远程控制,无需依赖本地驱动。
IPP(Internet Printing Protocol)
使用ipp库直接发送IPP请求:
import ipp
client = ipp.Client('http://192.168.1.100:631/ipp/print')
job_attrs = {
'printer-uri': 'ipp://192.168.1.100:631/ipp/print',
'requesting-user-name': 'python_user',
'job-name': 'IPP Print Job'
}
with open('document.pdf', 'rb') as f:
response = client.create_job(job_attrs, f.read())
print('任务ID:', response.operation_data['job-id'])
IPP协议优势:支持作业状态查询、取消、暂停等完整生命周期管理,符合RFC 2911标准。
SMB/CIFS网络共享
通过smbprotocol发送SMB2/3协议数据:
from smbprotocol.connection import Connection
from smbprotocol.session import Session
from smbprotocol.tree import TreeConnect
from smbprotocol.open import Open, CreateDisposition
# 连接SMB服务器
connection = Connection(uuid4(), '192.168.1.100', 445)
connection.connect()
session = Session(connection, 'username', 'password')
session.connect()
tree = TreeConnect(session, '\\\\192.168.1.100\\PrinterShare')
tree.connect()
# 创建并写入打印文件
with Open(tree, 'print_job.txt', create_disposition=CreateDisposition.CREATE_NEW) as open_file:
open_file.write(b'Hello from Python!\\n')
open_file.close()
注意:需确保打印机共享路径为可写,且防火墙允许SMB端口(445)通信。
HTTP REST API(厂商支持)
部分打印机(如HP、Epson)提供HTTP API:
import requests
url = 'http://192.168.1.100/print'
files = {'file': ('label.pdf', open('label.pdf', 'rb'), 'application/pdf')}
data = {'copies': '1', 'paper_size': 'A4'}
response = requests.post(url, files=files, data=data)
print(response.json())
适用设备:智能办公打印机(支持Web管理界面),需查阅厂商API文档。
跨平台网络打印最佳实践
推荐架构:Python后端服务 → CUPS打印服务(Docker容器化) → 网络打印机。通过容器化部署CUPS,实现打印服务与业务系统解耦,便于扩展与维护。
Docker Compose示例:
version: '3.8'
services:
cupsd:
image: cupsd:latest
ports:
- "631:631"
volumes:
- ./cupsd.conf:/etc/cups/cupsd.conf
- ./printers.conf:/etc/cups/printers.conf
restart: always
Python客户端仅需连接CUPS服务:conn = cups.Connection('http://localhost:631')
蓝牙与串口:热敏打印机直连控制
移动POS设备、手持终端常通过蓝牙连接热敏打印机,Python调用打印机需使用bluetooth库(Linux)或pyserial(串口)。
蓝牙热敏打印机(POS机)
扫描并连接蓝牙设备:
import bluetooth
# 扫描附近设备
devices = bluetooth.discover_devices(duration=8, lookup_names=True)
for addr, name in devices:
if 'POS' in name:
target_addr = addr
break
# 连接SPP服务
sock = bluetooth.BluetoothSocket(bluetooth.RFCOMM)
sock.connect((target_addr, 1)) # 通道1通常为SPP
发送打印指令:
data = b'\\x1B\\x40' # 初始化 data += b'Hello World!\\n' data += b'\\x1D\\x56\\x41\\x00' # 切纸 sock.send(data) sock.close()
USB转串口设备
使用pyserial操作串口(设备路径可能为/dev/ttyUSB0或COM3):
import serial
ser = serial.Serial('/dev/ttyUSB0', 9600, timeout=1)
ser.write(b'\\x1B\\x40') # 初始化
ser.write(b'Test Print\\n')
ser.close()
注意:波特率、数据位、停止位需与打印机设置一致,常见配置为9600 8N1。
ESC/POS指令集详解
ESC/POS是热敏打印机通用指令集,常用命令:
| 指令 | 功能 | 示例 |
|---|---|---|
| ESC @ | 初始化 | b'\\x1B\\x40' |
| GS V 0 | 切纸 | b'\\x1D\\x56\\x30' |
| ESC a n | 对齐方式 | b'\\x1B\\x61\\x31'(居中) |
| GS ( k | 二维码 | b'\\x1D\\x28\\x6B\\x30\\x30\\x31' |
| ESC ! n | 字号放大 | b'\\x1B\\x21\\x30'(2倍宽高) |
完整示例:
def print_receipt(items):
data = b'\\x1B\\x40' # 初始化
data += b'\\x1B\\x61\\x31' # 居中
data += b'\\x1D\\x21\\x30' # 2倍字号
data += b'ORDER #12345\\n'
data += b'\\x1D\\x21\\x00' # 恢复字号
data += b'\\x1B\\x61\\x30' # 左对齐
for item, price in items:
data += f'{item:<12}{price:>6}\\n'.encode()
data += b'\\x1D\\x56\\x41\\x00' # 切纸
return data
蓝牙配对问题解决方案
- • Linux需先通过bluetoothctl配对:
bluetoothctl > pair [MAC] > trust [MAC]; - • Windows需在设备管理器中设置为“输入设备”;
- • 部分设备需安装RFCOMM服务:
sudo apt install rfcomm; - • 建议使用固定蓝牙MAC地址(非随机地址),避免重启后失效。
条码与二维码打印专项方案
在电商、物流、仓储场景,Python调用打印机生成条码是核心需求,需结合条码规范与打印机指令。
条码标准与编码选择
常见条码类型及适用场景:
| 类型 | 编码字符 | 典型应用 |
|---|---|---|
| Code 128 | 全ASCII字符 | 物流、仓储 |
| EAN-13 | 数字(13位) | 零售商品 |
| QR Code | 任意数据 | 移动支付、营销 |
| PDF417 | 大容量数据 | 身份证、车票 |
编码选择原则:零售商品必须用EAN-13/UPC;物流用Code 128;需高容量数据选PDF417;移动端扫描优先用QR Code。
二维码生成与打印
使用qrcode库生成图像后打印:
import qrcode
from PIL import Image
# 生成二维码
qr = qrcode.QRCode(version=1, error_correction=qrcode.constants.ERROR_CORRECT_L)
qr.add_data('https://www.xservx.com')
qr.make(fit=True)
img = qr.make_image(fill_color='black', back_color='white')
# 保存为PNG
img.save('qrcode.png')
# 打印(CUPS)
conn = cups.Connection()
conn.printFile(conn.getDefault(), 'qrcode.png', 'QR Code', {'fit-to-page': 'true'})
对ESC/POS打印机,可直接生成二值化字节流:
def qr_to_escpos(qr_data):
qr = qrcode.QRCode(version=1)
qr.add_data(qr_data)
qr.make()
matrix = qr.get_matrix()
# 构造GS ( k指令
data = b'\\x1D\\x28\\x6B\\x30\\x30\\x31' # 设置QR模式
# 计算数据长度(字节数)
size = len(matrix) * len(matrix)
data += size.to_bytes(2, 'little')
# 压缩数据(每个模块1位)
bits = []
for row in matrix:
for col in row:
bits.append(1 if col else 0)
# 转为字节流
byte_list = []
for i in range(0, len(bits), 8):
byte = 0
for j in range(8):
if i+j < len(bits):
byte |= (bits[i+j] << (7-j))
byte_list.append(byte)
return b'\\x1B\\x40' + data + bytes(byte_list) + b'\\x0A'
标签打印设计工具链
推荐使用Labelary API(在线服务)或BarTender(桌面软件)设计模板,Python通过HTTP提交数据:
import requests
# 使用Labelary在线服务预览标签
with open('label.zpl', 'rb') as f:
response = requests.post(
'http://api.labelary.com/v1/printers/8dpmm/labels/4x6/0/',
files={'file': f},
headers={'Content-Type': 'application/x-www-form-urlencoded'}
)
# 保存PDF预览
with open('label_preview.pdf', 'wb') as f:
f.write(response.content)
生产环境:部署本地Labelary服务(Docker镜像),避免API限频。
防错机制:条码可读性验证
实际部署前需验证条码打印质量,方法:
- • 使用手机扫码APP测试识别率;
- • 打印测试页调整浓度(ESC t n)与间隙(GS h);
- • 对EAN-13检查校验位计算(最后一位为校验码);
- • QR Code设置错误纠正等级(L/M/Q/H),高风险场景用H级。
示例:调整打印机浓度(浓度值0-15):
def set_density(level):
# level: 0-15
return b'\\x1B\\x54\\x3' + bytes([level])
网友最关心问题解答
以下为开发者在Python调用打印机过程中高频提出的问题,结合实战经验深度解析。
Q1:为什么打印内容乱码或空白?
A:常见原因有三:① 编码错误(需用UTF-8 without BOM或ASCII);② 打印机未初始化(发送ESC @);③ 字体不支持(热敏打印机仅支持内置点阵字体)。解决方案:使用打印机厂商提供的测试指令集验证设备状态。
Q2:如何实现连续打印不卡顿?
A:关键在缓冲区管理:① 避免频繁开关连接(保持socket长连接);② 批量合并打印任务(使用线程池+队列);③ 对CUPS设置队列深度:lpoptions -d printer -o job-sheets=none,none。
Q3:Python脚本在服务器运行时无法打印?
A:服务器通常无图形界面,需:① 配置CUPS服务监听0.0.0.0(非仅localhost);② 设置打印机为“共享”;③ Python客户端连接服务器CUPS地址(如http://server:631)。注意防火墙开放631端口。
Q4:如何支持多语言(含中文)打印?
A:① 选择支持Unicode的打印机(如佳博GP-L802II);② 使用ESC t 0(Unicode模式);③ 确保文本编码为UTF-8。测试指令:print_raw_data(b'\\x1B\\x74\\x30\\xE4\\xBD\\xA0\\xE5\\xA5\\xBD')(你好)。
Q5:打印机突然断连如何恢复?
A:实现自动重连机制:① 每次打印前检测设备状态(CUPS用getJobs());② 设置超时重试(最多3次,间隔1秒);③ 记录失败任务至数据库,人工介入。示例代码见附录。
附录:完整重连机制代码
import time
import cups
def print_with_retry(pdf_path, max_retries=3):
for attempt in range(max_retries):
try:
conn = cups.Connection()
conn.printFile(conn.getDefault(), pdf_path, 'Job', {})
return True
except Exception as e:
print(f'打印失败({attempt+1}/{max_retries}): {e}')
if attempt < max_retries - 1:
time.sleep(1)
else:
# 记录失败任务
with open('failed_jobs.log', 'a') as f:
f.write(f'{time.time()},{pdf_path}\\n')
return False
return False