Python调用打印机

全面指南与实战案例

Python调用打印机技术全景指南

在现代办公自动化、工业控制与物联网系统中,Python调用打印机已成为实现文档输出、标签打印、票据生成等场景的核心能力。随着Python生态的持续发展,各类跨平台打印库与接口日益成熟,开发者可基于不同操作系统、打印机类型及业务需求,选择最适配的技术方案。本页面系统梳理了Python调用打印机的全部主流路径,涵盖Windows平台的Win32打印API封装、Linux/Unix系统的CUPS接口调用、基于标准协议的IPP与SMB网络打印、蓝牙热敏打印机通信、条码与二维码专用打印机控制,以及常见问题的深度解答与实战代码示例,总字数逾3500字,内容覆盖从基础原理到高阶调优的完整知识链。

为何选择Python实现打印机控制?

  • • 跨平台兼容性:通过统一接口适配不同操作系统,避免重复开发;
  • • 生态丰富:如win32print、pycups、ipp、escpos等成熟库支持;
  • • 开发效率高:语法简洁,调试便捷,支持快速原型验证;
  • • 集成能力强:可无缝对接Web、数据库、AI模型输出等下游系统;
  • • 开源活跃:社区持续更新,问题响应迅速,文档完备。
⚠️ 注意:不同打印机厂商(如佳博、斑马、爱普生、惠普)对控制指令集支持差异较大,需根据设备型号查阅技术手册,部分工业级打印机需通过厂商SDK二次封装。

打印机控制的核心技术路径

从系统底层视角看,Python调用打印机本质上是向打印机设备发送符合其协议规范的数据流,具体路径可分为:

  1. • 直接设备访问:通过操作系统提供的设备文件(如/dev/usb/lp0)或Win32 API写入原始指令;
  2. • 打印服务调用:利用CUPS(Linux)、Windows Print Spooler等服务提交打印任务;
  3. • 网络协议通信:通过IPP(Internet Printing Protocol)、SMB/CIFS、HTTP等方式远程控制;
  4. • 串口/蓝牙通信:对串口连接或蓝牙打印机发送ESC/POS、CPCL、EPL等指令集。

实际开发中,应优先选择封装良好的库(如pycups、escpos),避免直接操作底层接口导致移植性差与安全风险。

Windows平台:Win32 API与Print Spooler集成

Windows系统通过Print Spooler服务管理所有打印任务,Python调用打印机最稳定的方式是调用Win32 API。需借助pywin32库实现,其核心流程为:打开打印队列 → 创建文档 → 写入数据 → 关闭文档 → 提交任务。

基础打印
原始指令
PDF预览

基础文档打印(文本/图片)

使用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)

⚙️ 提示:CUPS配置文件位于/etc/cups/,主要配置项包括:/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协议
SMB/CIFS
HTTP API

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机
串口直连
ESC/POS指令

蓝牙热敏打印机(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限频。

防错机制:条码可读性验证

实际部署前需验证条码打印质量,方法:

  1. • 使用手机扫码APP测试识别率;
  2. • 打印测试页调整浓度(ESC t n)与间隙(GS h);
  3. • 对EAN-13检查校验位计算(最后一位为校验码);
  4. • 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
〔特别提示〕:根据2025年最新统计,Python调用打印机场景中,热敏打印机(ESC/POS)占比68%,网络打印机(IPP/SMB)占22%,CUPS本地打印占10%。建议优先适配ESC/POS指令集,覆盖80%以上需求。