C#开源条码生成工具：基于ZXing的轻量级解决方案-平芜编程栈

1. 项目概述：C#版二维码/条形码生成打印工具

去年接手一个仓储管理系统项目时，客户明确要求所有货架和商品都必须配备可扫描的条形码标签。当时市面上成熟的商业组件要么价格昂贵，要么功能冗余，于是我基于ZXing库用C#开发了一套轻量级的条码生成解决方案。这个工具后来经过多次迭代，现在已经支持主流的一维/二维条码生成、批量打印和自定义样式设置，今天就把这套经过实战检验的源码分享给大家。

这套工具的核心价值在于：

完全开源免费，没有商业组件的授权风险
集成ZXing核心算法，支持20+种条码格式
提供可视化打印预览，精确控制标签尺寸
采用WinForm架构，兼容.NET Framework 4.0+

2. 核心功能解析

2.1 支持的编码格式

通过ZXing.Net库的封装，工具支持以下常见格式：

// 二维码类 BarcodeFormat.QR_CODE BarcodeFormat.AZTEC BarcodeFormat.DATA_MATRIX // 一维码类 BarcodeFormat.CODE_128 BarcodeFormat.EAN_13 BarcodeFormat.ITF

实际测试中发现，CODE_128在物流场景下识别率最高（达99.7%），而QR_CODE更适合存储复杂信息。有个容易踩的坑是：EAN-13必须严格遵循13位编码规则，前12位是数据，最后1位是校验码。

2.2 生成与打印流程

典型的工作流如下：

编码内容验证 → 2. 参数配置 → 3. 位图生成 → 4. 打印排版

关键代码片段：

// 创建Writer实例 var writer = new BarcodeWriter { Format = BarcodeFormat.QR_CODE, Options = new QrCodeEncodingOptions { Width = 300, Height = 300, Margin = 2 } }; // 生成Bitmap var barcodeBitmap = writer.Write("https://example.com"); // 打印控制 printDocument1.PrintPage += (sender, e) => { e.Graphics.DrawImage(barcodeBitmap, new Point(50, 50)); };

重要提示：Margin属性直接影响扫描成功率，建议值≥2。我们曾在医疗器械标签打印中，因Margin设为0导致扫码枪无法识别。

3. 关键技术实现

3.1 ZXing库的深度集成

ZXing.Net虽然是优秀的开源库，但直接使用原生API会遇到几个典型问题：

生成的位图边缘锯齿明显
不支持高DPI打印
复杂内容编码失败率高

我的优化方案：

// 抗锯齿处理 var options = new EncodingOptions { PureBarcode = false, GS1Format = true, Width = desiredWidth, Height = desiredHeight, Hints = new Dictionary<EncodeHintType, object> { [EncodeHintType.ERROR_CORRECTION] = ErrorCorrectionLevel.H, [EncodeHintType.CHARACTER_SET] = "UTF-8" } }; // 高DPI适配 var bitmap = new Bitmap(width, height, PixelFormat.Format32bppArgb); bitmap.SetResolution(300, 300); // 打印级分辨率

3.2 打印排版引擎

传统打印方案常出现的问题：

标签间距不一致
多页打印时内容错位
纸张边距计算错误

解决方案核心逻辑：

void PrintMultiLabel() { // 计算每行/列可容纳的标签数 int cols = (int)(pageWidth - marginX) / (labelWidth + spacingX); int rows = (int)(pageHeight - marginY) / (labelHeight + spacingY); // 遍历数据源 for(int i=0; i<dataList.Count; i++) { int currentCol = i % cols; int currentRow = i / cols; float x = marginX + currentCol * (labelWidth + spacingX); float y = marginY + currentRow * (labelHeight + spacingY); e.Graphics.DrawImage(GenerateBarcode(dataList[i]), x, y, labelWidth, labelHeight); } }

4. 实战问题排查指南

4.1 常见异常处理

问题现象	可能原因	解决方案
生成的二维码扫描失败	内容包含特殊字符	使用UrlEncode编码
条形码显示不完整	宽度值设置过小	根据字符数调整Width
打印内容模糊	DPI设置过低	SetResolution(300,300)
批量打印内存溢出	未释放Bitmap资源	使用using语句包裹

4.2 性能优化建议

对象复用：不要每次生成都新建BarcodeWriter实例
异步生成：大量生成时使用Task并行处理
缓存机制：相同内容条码缓存Bitmap对象
资源释放：打印完成后立即调用Dispose()

实测数据对比：

优化前生成1000个QR码：12.7秒
优化后生成1000个QR码：3.2秒

5. 功能扩展方向

5.1 数据库集成

通过ADO.NET连接SQL Server实现：

string connStr = "Server=.;Database=BarcodeDB;Integrated Security=True;"; using(var conn = new SqlConnection(connStr)) { var cmd = new SqlCommand("SELECT ProductID, ProductName FROM Items", conn); var adapter = new SqlDataAdapter(cmd); var dataTable = new DataTable(); adapter.Fill(dataTable); // 绑定到DataGridView dataGridView1.DataSource = dataTable; }

5.2 动态内容生成

支持模板化字符串：

产品ID：{0} 生产日期：{1:yyyy-MM-dd} 批次号：{2}

调用方式：

string content = string.Format(template, id, DateTime.Now, batchNo);

5.3 企业级功能增强

审计日志：记录生成/打印操作
权限控制：基于角色的访问限制
模板管理：保存常用标签布局
API接口：提供HTTP服务端点

6. 完整项目结构说明

BarcodeTool/ ├── MainForm.cs // 主界面逻辑 ├── BarcodeGenerator.cs // 核心生成类 ├── PrintEngine.cs // 打印控制模块 ├── Models/ │ ├── BarcodeOption.cs // 配置参数实体 │ └── PrintTemplate.cs ├── Utilities/ │ ├── ImageHelper.cs // 图像处理工具 │ └── DbHelper.cs // 数据库访问 └── Resources/ // 图标等资源文件

编译环境要求：