核心结论
小票打印不仅是把 PDF 缩小。纸宽、字符密度、二维码尺寸、走纸距离和切刀能力都需要根据打印机 Profile 明确配置。
PDF 小票与 ESC/POS 有什么区别?
PDF 路径适合版式精确、图片和复杂排版,由系统驱动完成打印;ESC/POS 路径直接生成打印机理解的受控指令,更适合高速文本、二维码、条码、走纸与切纸。
普通 PDF 打印成功不代表设备一定支持自动切纸,切刀属于设备协议能力。
受控 ESC/POS 支持范围
业务系统提交结构化小票对象,Agent 根据已配置的打印机 Profile 编译指令,而不是开放任意 RAW 字节透传。
- 文本、对齐和基础强调
- 二维码与 Code 128 条码
- 自动走纸
- 全切或半切(取决于具体型号)
- 份数、幂等键和任务状态追踪
为什么不能自动猜测所有切刀能力?
不同品牌和型号对 ESC/POS 指令、USB/网络队列、驱动透传和切刀模式的支持并不完全一致。错误猜测可能导致乱码、空白小票或误切。
上线时应先选择目标机型,打印能力样张并记录 Profile,再将切刀能力加入允许列表。
小票上线验收清单
至少验证中文字体或字库、二维码可扫率、条码宽度、连续打印温度、走纸距离、全切/半切、缺纸恢复和断网重试。模板预览是辅助工具,实体样张才是最终验收依据。
常见问题
58mm 和 80mm 可以共用模板吗?+
可以共用业务数据,但不建议直接共用版式。应为不同有效打印宽度建立独立模板或明确的响应规则。
打印机有切刀就一定能切吗?+
不一定。还需要队列允许 RAW/ESC/POS 通道,并确认该型号支持的全切或半切指令。
网络小票机可以使用吗?+
可以,只要设备已添加到系统打印队列,当前 Agent 用户可访问,并完成目标通道与机型 Profile 验证。
内容说明
本文依据 Print Agent 当前仓库实现、协议文档与交付边界整理。平台兼容性以实际签名安装包、目标驱动和打印机型号的验收记录为准。
最后复核:2026-09-01