1. 项目概述
今天给大家分享一个我最近开发的C#标签打印程序的核心实现方案。这个项目最初源于我们公司内部对标签打印系统的需求——需要能够灵活设计各种规格的产品标签，支持动态生成条形码/二维码，并且要保证打印精度。市面上的商业软件要么功能过剩，要么定制性不足，于是我决定自己开发一套轻量级解决方案。
这套系统的核心价值在于：
- 可视化标签设计器：通过GDI+实现标尺、拖拽定位等设计功能
- 动态条码生成：集成ZXing库支持各类一维/二维码生成
- 打印精度控制：解决不同DPI设备的适配问题
- 模板化设计：XML序列化保存标签模板
- 高性能打印：实测连续打印1000张标签内存增长<5MB
2. 核心模块实现
2.1 设计器界面实现
设计器的核心是标尺系统和拖拽定位功能。我们先来看标尺绘制：
csharp复制private void DrawRuler(Graphics g, int step)
{
using var pen = new Pen(Color.Gray, 0.5f);
for (int x = 0; x < this.Width; x += step)
{
g.DrawLine(pen, x, 0, x, 15); // 横向刻度
if (x % 50 == 0) // 每50像素显示数字
g.DrawString(x.ToString(), Font, Brushes.Black, x, 16);
}
// 垂直标尺同理
}
关键技巧：标尺更新需要放在Paint事件中，并设置DoubleBuffered=true避免闪烁
拖拽功能的实现要点：
csharp复制private Point dragOffset;
private bool isDragging;
private void element_MouseDown(object sender, MouseEventArgs e)
{
isDragging = true;
dragOffset = e.Location;
((Control)sender).BringToFront();
}
private void element_MouseMove(object sender, MouseEventArgs e)
{
if (isDragging && e.Button == MouseButtons.Left)
{
Control ctrl = (Control)sender;
Point newPos = this.PointToClient(
Control.MousePosition) - new Size(dragOffset);
// 对齐到网格（可选）
int gridSize = 5;
newPos.X = (newPos.X / gridSize) * gridSize;
newPos.Y = (newPos.Y / gridSize) * gridSize;
ctrl.Location = newPos;
UpdatePositionLabel(ctrl.Location);
}
}
2.2 条码生成模块
使用ZXing.Net库实现条码生成，这里有几个关键点需要注意：
csharp复制public Bitmap GenerateBarcode(string content, BarcodeFormat format,
int width, int height, int margin = 2)
{
var writer = new BarcodeWriter
{
Format = format,
Options = new EncodingOptions
{
Height = height * 2, // 高分辨率处理
Width = width * 2,
Margin = margin,
PureBarcode = format == BarcodeFormat.CODE_128
}
};
// 特别处理QR码的纠错级别
if (format == BarcodeFormat.QR_CODE)
{
writer.Options.Hints.Add(
EncodeHintType.ERROR_CORRECTION,
ErrorCorrectionLevel.M);
}
var rawBitmap = writer.Write(content);
return new Bitmap(rawBitmap, width, height);
}
避坑指南：部分条码类型（如Code 128）需要设置PureBarcode=true，否则ZXing会默认添加文本标签
2.3 打印模块实现
打印模块最关键的毫米到像素的转换：
csharp复制private float GetDpiScale(Graphics g)
{
// 获取实际DPI（考虑打印机可能不同于屏幕）
float dpiX = g.DpiX;
return dpiX / 96f; // 96是标准屏幕DPI
}
private void PrintDocument_PrintPage(object sender, PrintPageEventArgs e)
{
e.Graphics.PageUnit = GraphicsUnit.Display;
float scale = GetDpiScale(e.Graphics);
foreach (var element in labelElements)
{
float x = element.X * scale;
float y = element.Y * scale;
float width = element.Width * scale;
float height = element.Height * scale;
if (element is BarcodeElement barcode)
{
var bmp = GenerateBarcode(barcode.Text,
barcode.Format,
(int)width,
(int)height);
e.Graphics.DrawImage(bmp, x, y);
bmp.Dispose();
}
else if (element is TextElement text)
{
using var font = new Font(text.FontName,
text.FontSize * scale);
e.Graphics.DrawString(text.Text, font,
Brushes.Black, x, y);
}
}
}
3. 高级功能实现
3.1 模板序列化设计
采用XML序列化保存标签模板：
csharp复制[XmlRoot("LabelTemplate")]
public class LabelTemplate
{
[XmlArray("Elements")]
[XmlArrayItem("Text", typeof(TextElement))]
[XmlArrayItem("Barcode", typeof(BarcodeElement))]
public List<LabelElement> Elements { get; set; }
[XmlAttribute]
public float Width { get; set; }
[XmlAttribute]
public float Height { get; set; }
}
public void SaveTemplate(string filePath)
{
var template = new LabelTemplate
{
Width = this.Width,
Height = this.Height,
Elements = GetElements()
};
var serializer = new XmlSerializer(typeof(LabelTemplate));
using var writer = new StreamWriter(filePath);
serializer.Serialize(writer, template);
}
3.2 动态加载条码生成器
通过反射实现插件式架构：
csharp复制public interface IBarcodeGenerator
{
Bitmap Generate(string content, int width, int height);
}
public class BarcodeFactory
{
private Dictionary<string, IBarcodeGenerator> _generators;
public BarcodeFactory()
{
_generators = new Dictionary<string, IBarcodeGenerator>();
LoadGenerators();
}
private void LoadGenerators()
{
var types = Assembly.GetExecutingAssembly()
.GetTypes()
.Where(t => t.GetInterfaces().Contains(typeof(IBarcodeGenerator))
&& !t.IsAbstract);
foreach (var type in types)
{
var generator = (IBarcodeGenerator)Activator.CreateInstance(type);
_generators.Add(generator.GetType().Name, generator);
}
}
public Bitmap GenerateBarcode(string type, string content,
int width, int height)
{
if (_generators.TryGetValue(type, out var generator))
return generator.Generate(content, width, height);
throw new NotSupportedException($"Barcode type {type} not supported");
}
}
4. 性能优化与调试
4.1 内存管理要点
GDI对象必须及时释放：
csharp复制// 错误示例 - 会导致内存泄漏
var pen = new Pen(Color.Red);
g.DrawRectangle(pen, rect);
// pen未释放
// 正确做法
using (var pen = new Pen(Color.Red))
{
g.DrawRectangle(pen, rect);
}
实测数据：正确处理Dispose的情况下，连续打印1000张标签内存增长仅3.7MB；未处理时内存增长达120MB+
4.2 打印机兼容性问题
常见问题及解决方案：
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 打印内容偏移 | 打印机边距设置 | 在打印首选项中调整页边距 |
| 条码模糊 | DPI不匹配 | 使用Graphics.DpiX获取实际DPI |
| 部分内容缺失 | 驱动缩放 | 设置e.Graphics.PageUnit = GraphicsUnit.Display |
| 打印速度慢 | 位图过大 | 按实际需要尺寸生成条码，不要缩放 |
4.3 单元测试建议
关键测试用例示例：
csharp复制[TestMethod]
public void TestBarcodeGeneration()
{
var generator = new BarcodeService();
var bmp = generator.GenerateQrCode("TEST", 100, 100);
Assert.IsNotNull(bmp);
Assert.AreEqual(100, bmp.Width);
// 验证二维码可被解码
var reader = new BarcodeReader();
var result = reader.Decode(bmp);
Assert.AreEqual("TEST", result.Text);
}
[TestMethod]
public void TestPrintTransformation()
{
var printer = new LabelPrinter();
float pixels = printer.MillimetersToPixels(10f, 300); // 300DPI
// 10mm @ 300DPI ≈ 118像素
Assert.AreEqual(118.11f, pixels, 0.1f);
}
5. 架构设计与扩展
5.1 分层架构建议
推荐的项目结构：
code复制LabelPrintingSystem/
├── LabelDesigner/ # 设计器UI
├── LabelCore/ # 核心逻辑
│ ├── Barcode/ # 条码生成
│ ├── Printing/ # 打印服务
│ └── Serialization/ # 模板序列化
├── Plugins/ # 扩展插件
└── LabelTemplates/ # 模板存储
5.2 扩展可能性
- 数据库集成：将标签模板存储在数据库中
- Web版设计器：使用Blazor重写前端
- 自动化打印：与ERP系统集成自动触发打印
- 标签预览：添加3D旋转预览功能
- 多语言支持：国际化资源文件
5.3 部署注意事项
- 打包ZXing.Core.dll为必需组件
- 提供打印机校准工具
- 添加DPI检测功能
- 建议最低.NET版本4.7.2
- 安装程序应检查GDI+可用性
我在实际开发中最大的体会是：打印系统的稳定性90%取决于对设备差异性的处理。特别是在企业环境中，不同型号的打印机行为可能大相径庭。因此建议在代码中加入完善的设备检测和自适应逻辑，比如自动识别打印机特性并调整输出策略。