核心结论

小票打印不仅是把 PDF 缩小。纸宽、字符密度、二维码尺寸、走纸距离和切刀能力都需要根据打印机 Profile 明确配置。

01

PDF 小票与 ESC/POS 有什么区别?

PDF 路径适合版式精确、图片和复杂排版,由系统驱动完成打印;ESC/POS 路径直接生成打印机理解的受控指令,更适合高速文本、二维码、条码、走纸与切纸。

普通 PDF 打印成功不代表设备一定支持自动切纸,切刀属于设备协议能力。

02

受控 ESC/POS 支持范围

业务系统提交结构化小票对象,Agent 根据已配置的打印机 Profile 编译指令,而不是开放任意 RAW 字节透传。

  • 文本、对齐和基础强调
  • 二维码与 Code 128 条码
  • 自动走纸
  • 全切或半切(取决于具体型号)
  • 份数、幂等键和任务状态追踪
03

为什么不能自动猜测所有切刀能力?

不同品牌和型号对 ESC/POS 指令、USB/网络队列、驱动透传和切刀模式的支持并不完全一致。错误猜测可能导致乱码、空白小票或误切。

上线时应先选择目标机型,打印能力样张并记录 Profile,再将切刀能力加入允许列表。

04

小票上线验收清单

至少验证中文字体或字库、二维码可扫率、条码宽度、连续打印温度、走纸距离、全切/半切、缺纸恢复和断网重试。模板预览是辅助工具,实体样张才是最终验收依据。

FAQ

常见问题

58mm 和 80mm 可以共用模板吗?

可以共用业务数据,但不建议直接共用版式。应为不同有效打印宽度建立独立模板或明确的响应规则。

打印机有切刀就一定能切吗?

不一定。还需要队列允许 RAW/ESC/POS 通道,并确认该型号支持的全切或半切指令。

网络小票机可以使用吗?

可以,只要设备已添加到系统打印队列,当前 Agent 用户可访问,并完成目标通道与机型 Profile 验证。

内容说明

本文依据 Print Agent 当前仓库实现、协议文档与交付边界整理。平台兼容性以实际签名安装包、目标驱动和打印机型号的验收记录为准。

最后复核:2026-09-01