barcodelib 支持 code128、code39、ean13、upca、itf14、postnet 等一维码,但需严格遵循格式要求:ean13 输入12位数字、upca 输入11位、itf14 输入13位且自动补零至14位、code39 必须用 * 包裹;生成时应设 barwidth≥2、height≥120px、quiet zone≥10×barwidth,并保存为 png 格式以确保扫码准确。

BarcodeLib 能生成哪些一维码?实际支持的类型别乱猜
BarcodeLib 支持的常见一维码类型有 Code128、Code39、EAN13、UPCA、ITF14、PostNet 等,但不是所有都默认启用或渲染正确。比如 Code128 默认会自动选择子集(A/B/C),而 EAN13 要求输入严格 12 位数字(校验位由库自动补),少一位或多一位都会抛出 ArgumentException。
容易踩的坑:
-
Code39允许字母和数字,但默认不校验,且必须用 * 包裹(如"*ABC123*"),否则生成图片内容错乱 -
UPCA输入必须是 11 位数字,库会自动计算第 12 位校验码;传 12 位反而报错 -
ITF14要求输入为 13 位数字,且只支持偶数长度——库内部会自动补前导 0 到 14 位,但原始字符串不能含非数字字符
生成图片时宽高和 DPI 怎么设才不模糊?
BarcodeLib 的 GenerateBarcode 方法返回的是 Bitmap,但默认分辨率是 96 DPI,直接保存为 PNG 在高清屏或打印场景下容易发虚。关键不是拉伸图片,而是从源头控制像素密度和条宽。
实操建议:
- 用
BarcodeLib.Barcode构造时,显式设置IncludeLabel = false(避免文字干扰尺寸计算) - 通过
Width和Height属性控制输出图像物理尺寸(单位:像素),例如 300×100 是常用扫码尺寸 - 真正影响清晰度的是
BarWidth(单条最小宽度,单位像素),设为2或3比默认1更稳妥,尤其对低分辨率打印机 - 生成后若需高 DPI,不要用
Bitmap.SetResolution(300, 300)——它只改元数据,不增加像素;应直接按目标 DPI 计算所需像素宽高再生成
中文标签怎么加?别在 Barcode 对象里硬塞
BarcodeLib 原生不支持中文字体渲染,IncludeLabel = true 只能显示 ASCII 字符,设成中文会变成方块或空格。想让条码下方带中文说明(如“商品编号:6923456789012”),得手动绘制。
做法是分两步:
- 先用 BarcodeLib 生成纯条码
Bitmap(IncludeLabel = false) - 新建一个更大的
Bitmap,用Graphics.FromImage获取绘图上下文 - 把原条码图
DrawImage到新图顶部,再用DrawString往底部写中文——注意选支持 GB2312/UTF8 的字体,如"SimSun"或"Microsoft YaHei" - 字体大小别超过条码高度的 1/3,否则扫码设备可能误识别
为什么生成的 EAN13 图片扫不出来?校验和条高是硬门槛
EAN13 对格式和图形精度极其敏感。常见失败原因不是代码逻辑错,而是输出不符合 GS1 规范:
- 输入字符串必须是 12 位纯数字,库会自动算第 13 位校验码;如果传了带校验位的 13 位数,
GenerateBarcode会静默截断或报错 - 条码总高度不能低于 10mm(约 120px @ 300DPI),否则手机摄像头难以对焦;BarcodeLib 默认高度太小,务必手动设
Height≥ 120 - 左右空白区(Quiet Zone)必须 ≥ 10 倍最窄条宽(
BarWidth × 10),库默认留得够,但如果你裁剪了 Bitmap 边缘,就可能破坏它 - 避免用
Bitmap.Save(..., ImageFormat.Jpeg)——JPEG 有损压缩会导致条边缘模糊,一律用Png
最易被忽略的一点:生成后务必用专业扫码工具(如「Barcode Scanner」Android App 或「在线条码校验网站」)验证,而不是只看图片是否“长得像”。有些看似正常的图,校验位错一位,所有扫描器都拒绝识别。










