打标设备
Zebra ZPL QR 码 ^BQ 语法说明
Admin2026年9月4日
斑马 ZPL 生成 QR 二维码核心命令：^BQ 完整结构：^FOx,y 设置坐标 → ^BQ二维码指令 → ^FD携带模式前缀 + 业务数据 → ^FS结束字段
1、^BQ 基础语法
^BQa,b,c,d,e
| 参数 | 名称 | 取值说明 |
|---|---|---|
| a | 方向 Orientation | N正常；R旋转90°；I旋转180°；B旋转270° 绝大多数场景固定写 N |
| b | QR模型 Model | 1旧版；2增强版（工业标签通用），默认2 |
| c | 放大系数 Magnification | 1‑100，控制二维码模块点大小； 203DPI常用2‑6；300DPI常用3‑8 |
| d | 掩码 Mask | 0‑7，一般省略，使用默认7 |
| e | 保留 | 一般省略 |
⚠️纠错等级不在 ^BQ 参数内！纠错等级写在^FD 的数据前缀里。
2、^FD 内数据前缀
格式：XX,实际内容，逗号不可省略，前缀区分模式与纠错等级。
| 前缀 | 模式 | 纠错 | 容错恢复能力 | 适用场景 |
|---|---|---|---|---|
| LA, | 自动A | L | 7% | 数据量大，追求大容量 |
| MA, | 自动A | M | 15% | 通用平衡，项目最常用 |
| QA, | 自动A | Q | 25% | 标签易磨损、油污 |
| HA, | 自动A | H | 30% | 高可靠性，可遮挡/破损严重 |
| LB, | 字节B | L | 7% | 二进制、含换行、特殊不可见字符 |
| MB, | 字节B | M | 15% | 二进制数据 |
模式 A：自动识别数字 / 字母；模式 B：原始 8bit 字节，适合中文、换行、二进制数据。
3、完整最小示例
示例 1：普通 URL 二维码
^XA
^FO50,50 ;二维码左上角坐标X=50,Y=50
^BQN,2,5 ;N正常方向,model2,放大系数5
^FDMA,https://www.smartransfer.cn^FS
^XZ
示例 2：带中文（必须开启 ^CI28 Unicode）
^XA
^CI28 ;开启Unicode，支持中文
^FO50,50
^BQN,2,5
^FDMA,产品序列号：SN‑20260904‑001^FS
^XZ
示例 3：QR 内容包含换行（^FH开启十六进制转义，_0D_0A=CRLF）
^XA
^FO50,50
^BQN,2,5
^FH^FDMB,第一行_0D_0A第二行_0D_0A第三行^FS
^XZ
4、常见踩坑点
- 漏掉前缀MA,/QA,：二维码会吃掉开头若干字符，扫码内容错乱。
- 中文乱码：必须加上^CI28；部分老打印机需要 JIS.DAT 字库。
- 二维码扫不出来但图案正常：放大系数 c 太小，打印模块过细；203dpi 建议≥3，300dpi≥4。
- 留白（静区 quiet zone）：QR 码四周至少保留 4 个模块空白，不要紧贴标签边缘。
- Model 务必写2，不要用 1，旧版兼容性差。
5、纠错等级选型建议
- 干净标签、大量数据：LA, L(7%)
- 普通工业标签（默认首选）：MA, M(15%)
- 容易刮花、油污：QA, Q(25%)
- 恶劣环境、可能局部遮挡：HA, H(30%)
一句话总结：ZPL QR 核心 ^BQN,2,放大倍数，纠错等级放在^FD的前缀MA,/QA,，中文务必开启^CI28。