C#怎么实现条形码生成 C#如何用BarcodeLib生成各种规格的一维条形码图片【工具】

C#怎么实现条形码生成 C#如何用BarcodeLib生成各种规格的一维条形码图片【工具】

用C#生成一维条形码，BarcodeLib是个绕不开的经典库。它支持的类型不少，但如果不清楚里面的“规矩”，生成的图片很可能扫不出来。这里把几个关键点说透，帮你避开常见的坑。

BarcodeLib 能生成哪些一维码？实际支持的类型别乱猜

先说结论，BarcodeLib确实支持Code128、Code39、EAN13、UPCA、ITF14、PostNet等主流一维码。但问题在于，每种类型都有严格的格式要求，不是随便传个字符串就能用的。

比如，Code128比较智能，会自动选择子集编码。而EAN13就严格得多，它要求你输入12位纯数字，库会自己计算第13位校验码。多一位或少一位？抱歉，直接抛出ArgumentException。

实际开发中，下面这几个坑最容易踩到：

• Code39必须用星号包裹：它虽然支持字母数字，但输入的字符串首尾必须用“*”包起来，比如"*ABC123*"。少了这个，生成的图案内容就是错的。
• UPCA只认11位：你需要提供11位数字，库会自动算出第12位校验码。如果你自作聪明把12位全传进去，反而会报错。
• ITF14的“自动补零”：这个类型要求输入13位数字，并且库内部会自动在前面补一个“0”，凑成14位。记住，原始字符串里不能有任何非数字字符。

生成图片时宽高和 DPI 怎么设才不模糊？

很多人发现，用BarcodeLib生成的图片在手机上看或者打印出来，边缘发虚、不够清晰。这通常不是代码错了，而是像素密度和物理尺寸没设对。

关键点在于，清晰度不是靠后期拉伸图片来提升的，而是要在生成时就控制好源头。具体怎么做？

• 先关掉标签：构造BarcodeLib.Barcode对象时，建议显式设置IncludeLabel = false。先专注于条码本身，避免底部文字干扰尺寸计算。
• 控制物理像素：通过Width和Height属性直接设定输出图像的像素尺寸。一个常见的、兼容性好的尺寸是300×100像素。
• 核心参数：BarWidth：这个参数决定了单条条码的最小宽度（单位是像素）。默认值1在低分辨率设备上可能太细。稳妥起见，设为2或3，识别成功率会高很多。
• 关于DPI的误区：别指望用Bitmap.SetResolution(300, 300)来提升清晰度。这个方法只修改了图像的元数据，并没有增加实际的像素信息。正确的做法是，根据你需要的打印DPI，反推出需要的像素宽高，然后让BarcodeLib直接生成对应尺寸的图。

中文标签怎么加？别在 Barcode 对象里硬塞

BarcodeLib本身不支持中文字体。如果你把IncludeLabel设为true并传入中文，显示出来的只会是一堆方块或空白。

想给条码加上中文说明（比如“产品序列号”），需要手动进行二次绘制。这个过程其实不复杂：

• 第一步：生成纯净条码。用BarcodeLib生成一个不带标签的Bitmap（确保IncludeLabel = false）。
• 第二步：创建画布并绘制。新建一个更大的Bitmap作为画布，获取它的Graphics对象。先把上一步生成的条码图，画到新画布的顶部。
• 第三步：添加中文文本。使用Graphics.DrawString方法，在条码下方绘制中文。字体务必选择支持中文的，比如“宋体”或“微软雅黑”。
• 最后注意比例：文字部分的高度最好不要超过条码本身高度的三分之一，否则可能会干扰扫码设备的识别区域。

为什么生成的 EAN13 图片扫不出来？校验和条高是硬门槛

EAN13（商品通用码）对格式规范的要求近乎苛刻。图片“长得像”条码，和“能被扫出来”是两回事。扫不出来，通常是因为触犯了下面几条“铁律”：

• 输入必须是12位：再次强调，你需要提供12位数字，第13位校验码必须交给库来计算。如果你传了13位，库可能会静默处理或报错，导致校验位错误。
• 高度是硬性指标：根据GS1规范，EAN13条码的物理高度不能低于10毫米。换算成像素，在300 DPI下至少需要120像素。BarcodeLib的默认高度往往不够，务必手动将Height属性设置为≥120。
• 留足“安静区”：条码左右两侧的空白区域（Quiet Zone）必须至少是最窄条宽（BarWidth）的10倍。库默认会留，但如果你生成后对图片进行了裁剪，很可能就把这个关键区域裁掉了。
• 保存格式用PNG：避免使用JPEG格式保存。JPEG的有损压缩会让条码边缘产生模糊和噪点，严重影响识别。一律使用无损的PNG格式。

最后给个忠告：生成条码后，务必用专业的扫码工具验证一下。可以用手机上的Barcode Scanner App，或者找在线的条码验证网站。肉眼看着没问题，不代表机器能读出来。校验位错一个数，所有扫描枪都会拒绝识别，这个检查步骤绝对不能省。