WPF 工业级标签打印库，支持零件/二维码/条码自定义设计

DotNet技术匠 · 6 天前

前言

工业现场经常遇到这种需求：零件要贴标签，箱子要贴标签，托盘也要贴标签。每种标签长得不一样——有的带二维码，有的带条码，有的就几个字。每次都现写一套打印逻辑？太折腾了。

最近看到一个基于 .NET 8.0 + WPF 的标签设计与打印库，正好解决这个问题。它提供可视化设计器，画好模板保存下来，程序里替换内容直接打印。这篇文章把这个库的功能和用法梳理了一遍，供有类似需求的同行参考。

项目介绍

一个用于工业或生产系统中打印自定义标签的 .NET 库，比如零件标签、二维码标签、条码贴纸等。

核心思路很简单：在界面上画出标签的样子，保存成模板，程序运行时往模板里填数据，然后发送给打印机。

它运行在 .NET 8.0 上，UI 部分用 WPF 实现，打印时支持毫米单位换算，可以精确控制尺寸，适合对接各种条码打印机。

项目功能

可视化标签设计器：基于 WPF 的图形界面，支持拖拽摆放文字、图片、二维码、条码等元素

模板保存与加载：设计好的标签可保存为 JSON 或 XML 文件，随用随加载

可替换元素提取：通过 GetLabelElementDic 方法获取模板中所有可替换字段

动态内容替换：程序运行时替换文字、二维码内容、图片等

打印输出：通过 PrintLabel 方法发送打印任务，支持指定打印机名称

尺寸与 DPI 支持：毫米与像素自动换算，打印时精确控制尺寸和边距

项目特点

所见即所得：拖拽式设计，不需要写代码画标签

模板复用：一套模板可以反复使用，每次替换数据即可

接口简洁：整个库只暴露三个核心方法，学习成本低

支持多种元素：文字、图片、二维码、条码都能放

打印机兼容性好：支持指定打印机名称，可以对接专用标签打印机

工业场景适配：支持边距控制、毫米单位，打印精度可调

项目技术

项目代码

方法一：设计标签

LabelService.DesignLabel();

调用后打开标签设计窗口。界面上有工具箱（文字、图片、二维码等），拖到画布上就能添加元素。每个元素可以调整位置、大小、字体、颜色。设计完成后保存为 JSON 模板文件（建议放在 Labels/ 目录下）。

方法二：获取可替换字段

var elementDic = LabelService.GetLabelElementDic("Labels/CarLabel.json");

解析模板文件，返回一个 Dictionary<string, string="">，键是元素的唯一标识，值是默认内容。比如一个模板里放了三个可替换元素，返回的结果大概是这个样子的：

{

"CarNumber": "ABC123",

"Date": "2025-10-21",

"QRCode": "http://example.com/123"

}

拿到这个字典，就知道模板里有哪些地方可以填数据了。

方法三：打印标签

bool success = LabelService.PrintLabel(

labelPath: "Labels/CarLabel.json",

valueDic: fields,

printerName: "ZDesigner ZT411",

paddingMm: 2,

out string message

);

参数说明：