1. 项目背景与核心功能
在数字化时代，二维码和条形码已经成为商业和个人生活中不可或缺的信息载体。从商品包装到活动签到，从支付系统到资产管理，这些黑白相间的小方块和条纹承载着大量数据。作为开发者，我们经常需要在自己的应用中集成条码生成功能，而C#作为企业级开发的主流语言，配合强大的ZXing库，可以轻松实现这一需求。
这个项目分享的是一个完整的C#源码解决方案，主要功能包括：
- 生成多种标准的一维条形码（如EAN-13、Code 128等）
- 创建可自定义的二维码（QR Code）
- 支持在二维码中心嵌入Logo图标
- 提供条码图像保存和打印功能
- 实现条码内容的读取和解析
提示：ZXing（Zebra Crossing）是一个开源的多平台条码处理库，其.NET版本ZXing.Net支持从Windows桌面应用到移动端的广泛场景。
2. 开发环境与依赖配置
2.1 基础环境准备
要运行和修改这个项目，你需要以下开发环境：
- Visual Studio 2019或更高版本（社区版即可）
- .NET Framework 4.7.2或.NET Core 3.1+
- Windows 10/11操作系统（因涉及打印功能）
2.2 关键NuGet包安装
通过NuGet包管理器安装以下依赖：
bash复制Install-Package ZXing.Net -Version 0.16.8
Install-Package ZXing.Net.Bindings.Windows.Compatibility -Version 0.16.8
ZXing.Net是核心功能库，而Windows.Compatibility提供了与Windows特定功能（如打印）的兼容支持。
2.3 项目结构说明
源码主要包含以下关键部分：
code复制/BarCodeGenerator
│── MainForm.cs # 主界面逻辑
│── BarcodeHelper.cs # 条码生成核心类
│── PrintService.cs # 打印服务封装
│── App.config # 应用程序配置
└── /Resources # 图片资源目录
3. 核心代码实现解析
3.1 一维码生成实现
以EAN-13标准为例，以下是核心生成代码：
csharp复制public Bitmap GenerateEAN13(string content, int width = 240, int height = 130)
{
var options = new EncodingOptions {
Height = height,
Width = width,
Margin = 1
};
var writer = new BarcodeWriter {
Format = BarcodeFormat.EAN_13,
Options = options
};
return writer.Write(content);
}
关键参数说明：
Margin：设置条码周围的空白边距（建议≥1）EAN_13：要求输入12或13位数字（自动计算校验位）- 尺寸建议：高度至少是宽度的1/3，否则可能影响扫描识别
3.2 二维码生成进阶
生成带Logo的二维码需要额外处理：
csharp复制public Bitmap GenerateQRCodeWithLogo(string text, string logoPath, int size = 300)
{
var qrOptions = new QrCodeEncodingOptions {
CharacterSet = "UTF-8",
Height = size,
Width = size,
Margin = 2
};
var writer = new BarcodeWriter {
Format = BarcodeFormat.QR_CODE,
Options = qrOptions
};
var qrBitmap = writer.Write(text);
// 添加Logo
using(var logo = Image.FromFile(logoPath))
using(var graphics = Graphics.FromImage(qrBitmap))
{
int logoSize = size / 5; // Logo尺寸为二维码1/5
var rect = new Rectangle(
(size - logoSize) / 2,
(size - logoSize) / 2,
logoSize,
logoSize
);
graphics.DrawImage(logo, rect);
}
return qrBitmap;
}
注意：Logo面积不应超过二维码总面积的30%，且建议使用高对比度的简单图标，否则会影响识别率。
3.3 打印功能实现
打印功能通过PrintDocument类实现：
csharp复制public void PrintBarcode(Bitmap barcode, string printerName = null)
{
var printDoc = new PrintDocument();
if(!string.IsNullOrEmpty(printerName))
printDoc.PrinterSettings.PrinterName = printerName;
printDoc.PrintPage += (sender, e) => {
var rect = e.MarginBounds;
e.Graphics.DrawImage(barcode, rect);
};
printDoc.Print();
}
打印优化建议：
- 先调用
PrintPreviewDialog进行预览 - 对于热敏打印机，设置
PrintDocument.DefaultPageSettings.PaperSize - 批量打印时使用
PrintDocument.OriginAtMargins = true
4. 实战应用与问题排查
4.1 常见应用场景
-
零售管理系统：
- 商品入库时生成EAN-13条码
- 打印价签和库存标签
csharp复制var barcode = GenerateEAN13(product.SKU); PrintService.PrintLabel(barcode, product.Price); -
活动签到系统：
- 为每位参与者生成唯一QR码
- 包含用户ID和加密校验信息
csharp复制var qrContent = $"{userId}|{GetHash(userId+secretKey)}"; var ticket = GenerateQRCode(qrContent); -
资产追踪：
- 为设备生成Code 128格式资产标签
- 包含资产编号和部门信息
4.2 典型问题解决方案
问题1：生成的二维码扫描识别率低
可能原因及解决：
- 对比度不足 → 确保背景纯白，条码纯黑
- 边缘留白不足 → 设置
Margin ≥ 2 - 内容过长 → 对URL等长内容使用短链服务
- 分辨率太低 → 增大生成尺寸（至少300×300像素）
问题2：打印的条码无法被扫描枪读取
排查步骤：
- 检查打印浓度（调整打印机DPI设置）
- 验证条码尺寸是否符合标准（如EAN-13高度≥25mm）
- 测试不同扫描角度（某些线性扫描枪对倾斜敏感）
- 尝试更换条码类型（Code 39兼容性最好）
问题3：中文内容显示乱码
解决方案：
csharp复制var options = new QrCodeEncodingOptions {
CharacterSet = "UTF-8" // 必须显式设置
};
5. 性能优化与扩展
5.1 批量生成优化
当需要生成大量条码时，建议：
-
复用BarcodeWriter实例：
csharp复制var writer = new BarcodeWriter(); // 初始化成本较高 // 在循环中只更新内容 foreach(var item in items) { writer.Write(item.Code); } -
并行处理：
csharp复制
Parallel.ForEach(items, item => { GenerateBarcode(item.Code); });
5.2 扩展功能建议
-
数据库集成：
csharp复制// 从数据库读取产品信息生成条码 var products = dbContext.Products.Where(p => !p.HasBarcode); foreach(var p in products) { p.BarcodeImage = GenerateEAN13(p.SKU); } -
Web API服务：
csharp复制[HttpGet("qrcode")] public IActionResult GetQrCode(string text, int size = 300) { var barcode = GenerateQRCode(text, size); using var ms = new MemoryStream(); barcode.Save(ms, ImageFormat.Png); return File(ms.ToArray(), "image/png"); } -
动态内容二维码：
csharp复制// 生成可更新内容的QR码 var dynamicUrl = $"https://yourdomain.com/qr/{Guid.NewGuid()}"; var qr = GenerateQRCode(dynamicUrl); // 后台关联该GUID与实际内容
6. 完整源码结构解析
项目主要包含以下关键类：
-
BarcodeGenerator- 主窗体- 控件事件处理
- 用户界面更新
- 打印预览功能
-
BarcodeHelper- 核心功能类csharp复制public static class BarcodeHelper { public static Bitmap GenerateBarcode(string content, BarcodeFormat format, int width, int height); public static Bitmap GenerateQRCode(string text, int size = 300); public static string ReadBarcode(Bitmap image); } -
PrintService- 打印服务csharp复制public class PrintService { public static void Print(Bitmap image); public static void PrintPreview(Bitmap image); public static IEnumerable<string> GetPrinterList(); } -
AppConfig- 配置管理csharp复制public static class AppConfig { public static string DefaultPrinter { get; set; } public static int DefaultQRSize { get; set; } // 其他配置项... }
7. 部署与使用指南
7.1 编译与打包
- 使用Visual Studio的"发布"功能生成安装包
- 建议包含以下依赖项：
- .NET Framework 4.7.2运行库
- VC++ 2019 Redistributable
7.2 用户操作流程
-
生成条码：
- 选择条码类型（EAN-13/QR Code等）
- 输入内容（注意格式要求）
- 调整尺寸和边距
- 点击"生成"按钮
-
保存/打印：
- 使用"保存"按钮导出PNG/JPEG
- 选择打印机后点击"打印"
- 通过"打印预览"调整布局
-
读取条码：
- 点击"选择图片"加载条码图像
- 点击"读取"按钮解析内容
7.3 自定义修改建议
-
修改
App.config添加默认打印机设置：xml复制<appSettings> <add key="DefaultPrinter" value="Microsoft Print to PDF"/> <add key="QRCodeSize" value="300"/> </appSettings> -
扩展支持的条码类型：
csharp复制// 在BarcodeHelper中添加新方法 public static Bitmap GenerateCode128(string content) { // 实现类似GenerateEAN13 } -
添加数据库支持：
- 集成Entity Framework Core
- 创建Product/Barcode关联模型
在实际项目中，我发现条码生成最容易出问题的环节往往是打印配置和尺寸设置。特别是在使用热敏打印机时，需要特别注意DPI设置与物理尺寸的对应关系。一个实用的技巧是先在A4纸上测试打印，确认无误后再切换到标签纸打印。