ZPL 查看器：预览 ZPL 标签
最后更新 2026-10-23
标签送进打印机之前，先在屏幕上看清它长什么样：从 UCC 模板库选零售商模板填表，或粘贴自己的 ZPL，再预览、复制，或下载成 ZPL、PNG、PDF。
ZPL 是告诉标签打印机「印什么、印在哪里」的指令语言。光看代码很难判断版面——某个字段偏了两毫米，往往印出来才发现。ZPL 查看器（Utilities → ZPL Viewer，/utilities/zpl-viewer）会先按您设的标签尺寸和打印机分辨率，把标签画在屏幕上，让您在真正打印之前先检查版面。它有两种用法：从 UCC 模板库里已存的零售商标签模板出发，只填数值；或者粘贴您自己的 ZPL 代码来预览。预览在本机浏览器里本地绘制。
第一步：选择零售商模板#
- 打开 Utilities → ZPL Viewer（/utilities/zpl-viewer）。页面默认是「零售商模板」模式——如果停在「自定义 ZPL」，用顶部的切换按钮切回来。
- 打开模板下拉框选一个模板。可以输入关键字搜索；每条显示为「零售商 · 模板名」。
- 选好后，下拉框旁会显示这个模板的尺寸、版本和标签类型，下面的标签宽高也会按模板自动填好。
- 这个列表里只有 UCC 标签模板。模板本身在 WMS → UCC Templates（/wms/templates）里新建和编辑；查看器只是使用它们。
- 如果下拉框显示「没有找到 UCC 模板」，说明还没有可选的模板——先到 WMS → UCC Templates（/wms/templates）里添加，或者用下文的自定义 ZPL 模式。
第二步：填写标签内容#
- 在「填写标签内容」卡片里，模板里写了几个占位符，就会出现几个输入框（占位符在模板 ZPL 里长这样：[[...]]）。输入框上方的名字会告诉您该填什么。
- 逐个输入框填写数值。模板下面的 ZPL 会随输入即时更新，右侧预览稍等片刻就会自动重画。
- 表单填乱了？点卡片上方的「重置」，所有输入框会清空，可以重填。
- 留空的输入框，它的占位符会原样留在 ZPL 里，页面会用「未填写的占位符」提示逐个列出来——把它们都填完，再把这张标签当成成品。
- 有两个字符会被自动从填入值里去掉：^ 和 ~。它们在 ZPL 里是控制字符，值里带上会把标签弄坏——填名称、地址时别用这两个字符。
或者：粘贴您自己的 ZPL（自定义 ZPL 模式）#
- 把 Utilities → ZPL Viewer（/utilities/zpl-viewer）顶部的切换按钮切到「自定义 ZPL」。
- 把您的 ZPL 粘贴到「ZPL 代码」框里，或直接改框里的内容——框里预填了一个简短例子（一张简单的 “Hello ZPL” 标签），可以先看清代码长什么样。
- 右侧预览会跟着您的修改变化，和模板模式一样。
第三步：设置标签尺寸与分辨率，看预览#
- 设置标签的宽度和高度（英寸）。模板模式下会按模板自己存的尺寸自动填（模板没写尺寸时是 4 × 6 英寸）；自定义模式下默认 4 × 6——改成您实际打印用的标签尺寸。
- 选与您的打印机一致的分辨率：203 dpi（8 dots/mm，常见的热敏规格）或 300 dpi（12 dots/mm，更清晰）。预览里的文字和条码会按这个清晰度绘制。
- 任何修改之后，预览都会稍等片刻自动重画。如果觉得预览没跟上，点「渲染预览」立即重画一次。
- 如果标签代码里用了这个查看器不支持的指令，那条指令会被跳过，并在预览下方以「暂不支持的指令（已跳过）」列出来。标签其余部分照常绘制——但信任预览之前，先看一眼这个列表。
- 如果预览完全画不出来，会出现一条报错让您检查 ZPL 代码——最常见的原因是代码缺了开始或结束标记。
第四步：复制或下载标签#
- 点「复制 ZPL」，把最终的 ZPL 代码（填好的值已经替换进去）复制到剪贴板，随处可粘贴使用。
- 或者按需要的格式下载标签：ZPL 按钮把代码下载成 .zpl 文件，PNG 把预览下载成图片，PDF 把它下载成文档——PDF 的页面正好就是您设的标签尺寸。
查看器现在多了设备打印按钮：把整段 ZPL 原文走 Device Hub 打印通道发给打印机（本地优先、云端兜底）。没装 Hub 或没配对时，回退到原来的弹窗方式。打印前还是先检查预览、未填占位符提示和不支持指令列表。
本文用到的 Docklify 功能#
- ZPL 查看器——Utilities → ZPL Viewer（/utilities/zpl-viewer）
- 带占位符填表表单的零售商标签模板——Utilities → ZPL Viewer → 零售商模板模式（/utilities/zpl-viewer）
- UCC 模板库（标签模板的新建与编辑处）——WMS → UCC Templates（/wms/templates）
- 按真实尺寸与分辨率（203 / 300 dpi）的标签预览，及复制与 ZPL / PNG / PDF 下载——Utilities → ZPL Viewer → 打印预览（/utilities/zpl-viewer）