Python-escpos：控制热敏打印机的利器
python-escpos 是一个功能强大的 Python 库，专门用于与支持 ESC/POS 指令集的票据打印机（热敏打印机）进行通信，无论是超市小票、餐厅点餐单还是物流标签，开发者都可以通过该库轻松实现打印控制。
主要功能特点
- 多接口支持：支持通过 USB、串口 (Serial)、网络 (Network/Ethernet) 以及 并行端口 连接打印机。
- 丰富的打印内容：支持打印文本、位图图像、一维条形码、二维码（QR Code）。
- 硬件控制：支持控制切纸刀、钱箱、蜂鸣器以及设置打印机状态。
- 跨平台：可以在 Linux、Windows 和 macOS 上运行。
安装方法
在终端或命令行中使用 pip 即可快速安装：
pip install python-escpos
快速入门示例
以下是一个通过 USB 连接打印机的简单示例：
from escpos.printer import Usb
# 初始化打印机
# 需替换为实际的 vendor_id 和 product_id (可通过 lsusb 命令查看)
p = Usb(0x04b8, 0x0202)
# 打印文本
p.text("Hello Worldn")
p.set(align='center', font='a', width=2, height=2)
p.text("欢迎光临n")
# 打印二维码
p.qr("https://www.example.com")
# 切纸
p.cut()
核心注意事项
在实际开发过程中,请务必关注以下几点：
-
USB 权限问题 (Linux)
：
- 在 Linux 系统下，普通用户通常没有直接访问 USB 设备的权限。
- 你需要配置 udev 规则，或者以 root 权限运行脚本（不推荐生产环境）。
- 可以创建一个文件
/etc/udev/rules.d/99-printer.rules，添加相应的设备 ID 权限。
-
依赖环境：
- USB 打印通常依赖 libusb 库，在安装
python-escpos之前，请确保系统已安装libusb及其开发头文件。
- USB 打印通常依赖 libusb 库，在安装
-
打印机兼容性：
- 虽然大多数热敏打印机声称支持 ESC/POS，但不同厂家对指令的实现可能存在差异。
- 如果遇到打印乱码或指令无效,请查阅打印机的技术手册，确认其支持的指令集。
-
网络打印：
- 如果使用网络打印机,只需将
Usb替换为Network类，并传入打印机的 IP 地址 即可。
- 如果使用网络打印机,只需将
常用连接方式类
在代码中,你可以根据连接方式选择不同的类进行初始化：
escpos.printer.Usb: 用于 USB 连接。escpos.printer.Network: 用于以太网/Wi-Fi 连接。escpos.printer.Serial: 用于 RS232 串口连接。escpos.printer.File: 用于将打印指令输出到文件（用于调试）。
通过 python-escpos，你可以将复杂的打印指令封装在 Python 代码中，极大地简化了票据打印系统的开发难度。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/python-escpos%e6%80%8e%e4%b9%88%e7%94%a8%ef%bc%8c%e5%a6%82%e4%bd%95%e8%bf%9e%e6%8e%a5%e7%83%ad%e6%95%8f%e6%89%93%e5%8d%b0%e6%9c%ba%ef%bc%9f/
