C#使用ZXing.NET实现二维码与条形码生成打印工具

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

在零售、仓储、物流等行业中，二维码和条形码的生成与打印是日常刚需。许多商业软件虽然功能完善，但要么价格昂贵，要么存在功能限制。作为C#开发者，我们完全可以用ZXing这样的开源库，自己打造一个轻量、高效的条码工具。这个项目将分享如何用C#和ZXing.NET实现一个具备完整生成、预览和打印功能的工具，所有源码可直接用于生产环境。

我曾在多个仓储管理项目中集成过类似功能，实测ZXing库的识别率与商业软件不相上下。相比直接调用第三方API，本地生成的方案不仅零成本，还能完全掌控生成规则和打印格式。下面就从环境搭建到功能实现的完整链路，分享这个工具的实战开发过程。

2. 开发环境与核心组件准备

2.1 开发工具选型

推荐使用Visual Studio 2022 Community版（免费）作为开发环境，创建Windows窗体应用(WinForms)项目。WinForms相比WPF更轻量，对打印功能的支持也更直接。项目目标框架建议选择.NET 6或更高版本，以获得更好的性能和新特性支持。

注意：如果项目需要跨平台，可改用Avalonia UI框架，但打印功能需要额外处理

2.2 必须的NuGet包

通过NuGet包管理器安装以下关键组件：

bash复制Install-Package ZXing.Net -Version 0.16.8
Install-Package ZXing.Net.Bindings.Windows.Forms -Version 0.16.8
Install-Package System.Drawing.Common -Version 7.0.0

ZXing.Net是核心条码处理库，其Windows.Forms绑定包提供了方便的UI控件。System.Drawing.Common则是处理图像和打印的关键依赖。

2.3 打印机兼容性测试清单

不同型号的打印机对条码的解析能力有差异，建议在代码中加入这些兼容性处理：

• 热敏打印机：设置最小DPI为203
• 激光打印机：关闭"节省墨粉"模式
• 喷墨打印机：使用高质量打印设置
• 标签打印机：校准标签尺寸参数

3. 核心功能实现详解

3.1 二维码生成模块

创建一个BarcodeGenerator类处理生成逻辑：

csharp复制public Bitmap GenerateQRCode(string content, int width, int height, int margin = 2)
{
    var writer = new BarcodeWriter<Bitmap>
    {
        Format = BarcodeFormat.QR_CODE,
        Options = new QrCodeEncodingOptions
        {
            Width = width,
            Height = height,
            Margin = margin,
            CharacterSet = "UTF-8",
            ErrorCorrection = ErrorCorrectionLevel.H
        }
    };
    return writer.Write(content);
}

关键参数说明：

• ErrorCorrectionLevel.H：提供30%的纠错能力，即使部分损坏仍可扫描
• UTF-8字符集：支持中文等非ASCII字符
• Margin：留白防止扫描器误判边界

3.2 条形码生成模块

支持常见的CODE_128、EAN_13等格式：

csharp复制public Bitmap GenerateBarcode(string content, BarcodeFormat format, int width, int height)
{
    var writer = new BarcodeWriter<Bitmap>
    {
        Format = format,
        Options = new EncodingOptions
        {
            Width = width,
            Height = height,
            PureBarcode = true
        }
    };
    return writer.Write(content);
}

经验：商品条码建议使用EAN_13，物流单用CODE_128，药品用CODE_39

3.3 打印功能实现

打印流程需要处理这些关键点：

1. 获取打印机设置
2. 计算页面布局
3. 处理打印事件

示例代码：

csharp复制private void PrintBarcode(Bitmap barcode, string printerName)
{
    PrintDocument pd = new PrintDocument();
    pd.PrinterSettings.PrinterName = printerName;
    
    pd.PrintPage += (sender, e) => 
    {
        var rect = e.MarginBounds;
        e.Graphics.DrawImage(barcode, rect);
    };
    
    pd.Print();
}

打印优化技巧：

• 预生成打印预览图
• 批量打印时使用打印队列
• 添加打印机状态检测

4. 高级功能与性能优化

4.1 批量生成与打印

实现批量处理需要关注：

• 内存管理：及时释放Bitmap资源
• 进度反馈：使用BackgroundWorker
• 错误处理：单条失败不影响整体

建议代码结构：

csharp复制public void BatchGenerate(List<string> contents, string outputFolder)
{
    Parallel.ForEach(contents, (content) => {
        var bmp = GenerateQRCode(content, 300, 300);
        bmp.Save(Path.Combine(outputFolder, $"{content}.png"));
        bmp.Dispose();
    });
}

4.2 自定义样式支持

通过ZXing的Renderer参数可以：

• 修改条码颜色
• 添加Logo水印
• 调整密度和旋转角度

示例：

csharp复制var renderer = new BitmapRenderer
{
    Foreground = Color.Blue,
    Background = Color.White,
    TextFont = new Font("Arial", 12)
};

4.3 性能实测数据

在i5-1135G7处理器上的测试结果：

优化建议：

• 对静态内容缓存生成结果
• 使用对象池管理Bitmap
• 异步加载大列表

5. 常见问题与解决方案

5.1 扫描识别率低

可能原因及对策：

1. 对比度不足 → 调整前景/背景色
2. 尺寸过小 → 增大生成尺寸
3. 打印模糊 → 改用矢量输出
4. 格式错误 → 验证内容规范

5.2 中文乱码问题

确保做到：

1. 生成时指定UTF-8编码
2. 字体支持中文
3. 扫描器开启Unicode模式

测试用例：

csharp复制var text = "中文测试";
var bmp = GenerateQRCode(text, 500, 500);
Assert.AreEqual(text, DecodeQRCode(bmp)); // 验证解码结果

5.3 打印偏移校正

不同打印机需要校准这些参数：

• 页边距（通常2-5mm）
• DPI设置（203/300/600）
• 纸张来源（自动选择/手动送纸）

创建校准页面：

csharp复制public Bitmap CreateTestPage()
{
    var bmp = new Bitmap(800, 600);
    using var g = Graphics.FromImage(bmp);
    g.DrawRectangle(Pens.Red, 50, 50, 700, 500);
    return bmp;
}

6. 项目扩展方向

6.1 数据库集成

典型应用场景：

• 连接SQL Server获取产品信息
• 自动生成带序号的标签
• 记录打印日志

示例代码：

csharp复制public void GenerateFromDatabase(string connectionString)
{
    using var conn = new SqlConnection(connectionString);
    var cmd = new SqlCommand("SELECT ProductID,Name FROM Products", conn);
    
    var dt = new DataTable();
    new SqlDataAdapter(cmd).Fill(dt);
    
    foreach(DataRow row in dt.Rows)
    {
        var content = $"{row["ProductID"]}|{row["Name"]}";
        var barcode = GenerateBarcode(content, BarcodeFormat.CODE_128, 300, 150);
        // 保存或打印...
    }
}

6.2 WebAPI接口

通过ASP.NET Core暴露生成服务：

csharp复制[HttpGet("qrcode")]
public IActionResult GetQRCode([FromQuery]string text, [FromQuery]int size = 300)
{
    var bmp = _generator.GenerateQRCode(text, size, size);
    var ms = new MemoryStream();
    bmp.Save(ms, ImageFormat.Png);
    return File(ms.ToArray(), "image/png");
}

6.3 移动端适配

使用Xamarin或MAUI移植到移动端的关键修改：

1. 替换ZXing的绑定包为移动版
2. 调整UI布局适应小屏幕
3. 添加相机扫描功能

我实际开发中发现，同样的核心代码在Android和iOS上需要调整：

• iOS需要额外处理图片方向
• Android要注意内存限制
• 移动端打印通常通过云服务实现

这个工具类项目虽然看起来简单，但在实际业务场景中能发挥很大价值。特别是在需要定制化条码规则的场景，自主开发的方案比商业软件更灵活。所有源码已经过多个实际项目验证，可以直接集成到您的系统中。