BarcodeLib 与 IronBarcode：C# 条形码库对比

条形码库核心生成模式

标准的 条形码库 生成工作流程需要创建实例、配置属性并调用 Encode():

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

// BarcodeLib
using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

var b = new Barcode();
b.IncludeLabel = true;
b.Width = 300;
b.Height = 100;
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");
img.Save("barcode.png", ImageFormat.Png);

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging

Dim b As New Barcode()
b.IncludeLabel = True
b.Width = 300
b.Height = 100
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345")
img.Save("barcode.png", ImageFormat.Png)

这是完整的生成工作流程。 属性设置器模式是这样的设计：所有配置都在调用 Encode() 之前在实例上进行，返回值是一个 System.Drawing.Image，必须单独保存或转换为字节。

详细功能对比

条形码库方法

BarcodeLib 需要先构造一个实例并设置属性，然后再调用 Encode()。 输出是一个 System.Drawing.Image 对象：

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

using BarcodeLib;
using System.Drawing;
using System.Drawing.Imaging;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    b.Width = 300;
    b.Height = 100;
    Image img = b.Encode(TYPE.CODE128, data);

    using var ms = new MemoryStream();
    img.Save(ms, ImageFormat.Png);
    return ms.ToArray();
}

Imports BarcodeLib
Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.IO

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    b.Width = 300
    b.Height = 100
    Dim img As Image = b.Encode(TYPE.CODE128, data)

    Using ms As New MemoryStream()
        img.Save(ms, ImageFormat.Png)
        Return ms.ToArray()
    End Using
End Function

返回类型 System.Drawing.Image 表示字节数组输出需要 MemoryStream 中间体。 IncludeLabel 属性是一个布尔切换开关 — 条形码库 会自动将编码后的数据字符串渲染为条形图下方的可见标签。

IronBarcode方法

IronBarcode 的生成是完全静态的。 CreateBarcode() 之后的配置链，以及输出方法直接终止该链：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddAnnotationTextBelowBarcode(data)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddAnnotationTextBelowBarcode(data)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateCode128(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .AddAnnotationTextBelowBarcode(data) _
        .ToPngBinaryData()
End Function

.ToPngBinaryData() 直接返回字节数组——没有中间 Image 或 MemoryStream 对象。 .AddAnnotationTextBelowBarcode() 显式地接受标签字符串，从而控制条形图下方显示的文本。 有关高级生成场景，请参阅IronBarcode条形码生成文档。

条形码库方法

BarcodeLib 没有读取 API。 没有 Decode()、Scan() 或 ReadBarcode() 方法。 这并非版本差异——阅读从来都不是图书馆设计的一部分。 任何调用解码方法的尝试都会导致编译错误：

// 条形码库 — reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

// 条形码库 — reading does not exist
using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method
// var value = b.Decode("barcode.png");       // CS1061: no definition
// var value = b.Scan("barcode.png");          // CS1061: no definition
// var value = b.ReadBarcode("barcode.png");   // CS1061: no definition

// The only thing you can do is generate:
Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345");  // this works

Imports BarcodeLib

Dim b As New Barcode()

' This will not compile — there is no Decode or Read method
' Dim value = b.Decode("barcode.png")       ' No definition
' Dim value = b.Scan("barcode.png")         ' No definition
' Dim value = b.ReadBarcode("barcode.png")  ' No definition

' The only thing you can do is generate:
Dim img As Image = b.Encode(TYPE.CODE128, "PRODUCT-12345") ' this works

需要同时具备 条形码库 的生成和读取功能的团队必须添加第二个库（通常是 ZXing .NET ），这会带来自身的依赖管理负担和第二个需要维护的 API 接口。

IronBarcode方法

BarcodeReader.Read() 接受图像文件、PDF 文件、流和 System.Drawing.Bitmap 对象。 读取PDF文件不需要额外的库：

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

' Read from an image
Dim results = BarcodeReader.Read("barcode.png")
Console.WriteLine(results.First().Value)  ' "PRODUCT-12345"

' Read all barcodes from a PDF — no separate PDF library needed
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

ReadingSpeed 枚举允许针对高容量场景调整扫描性能。 有关读取配置的指导，请参阅IronBarcode读取文档。

条形码库方法

从 条形码库 3.x 开始，该库引入了 SkiaSharp 作为图形后端，以取代 System.Drawing.Common，后者在 .NET 6 之后仅支持 Windows。BarcodeLib 绑定到特定的 SkiaSharp 版本范围。 如果一个项目已经通过另一个依赖项使用 SkiaSharp（这在 MAUI 项目中很常见，因为使用了 SkiaSharp.Views.Maui 和 Microsoft.Maui.Graphics），则解析后的版本可能超出 条形码库 的预期范围。 最轻的结果是出现 NU1608 警告，最重的结果是运行时程序集绑定失败：

警告 NU1608：检测到软件包版本超出依赖关系约束：
BarcodeLib 3.1.5 需要 SkiaSharp (>= 2.88.7 && < 2.89.0)，但
SkiaSharp 3.116.1 版本问题已解决。

通过显式包引用强制解析会增加复杂性，而且无法保证成功：

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

即使进行了显式覆盖，兼容性也取决于 条形码库 的内部 API 调用是否与固定版本公开的内容相匹配。 没有任何支持合同能够保证在对项目至关重要的进度时间内修复问题。

IronBarcode方法

IronBarcode不与应用程序代码共享 SkiaSharp 依赖关系图。 无需管理版本协商，无需诊断 NU1608，也无需承担与 SkiaSharp 版本解析相关的运行时程序集绑定风险。 MAUI 项目、 Blazor项目以及任何其他依赖 SkiaSharp 的应用程序都可以安装IronBarcode，而不会出现任何版本冲突。 有关 MAUI 的特定集成模式，请参阅IronBarcode MAUI 文档。

阅读要求出现

一个已经生成货运标签数月的系统迎来了一个新的要求：该应用程序还必须处理供应商退回的标签。 仓库集成需要解析入库货物清单中的条形码。 文档管理系统需要对扫描的PDF文件中的条形码进行索引。 条形码库 无法满足这些要求——它没有读取 API。团队评估了将 ZXing .NET与 条形码库 结合使用的可能性，权衡了双库维护的负担和两个独立的依赖关系图，最终决定更简洁的方案是使用一个库，通过单个NuGet安装即可处理生成和读取操作。

SkiaSharp 在 MAUI 项目中的冲突

一个团队将 条形码库 添加到现有的 MAUI 应用程序中，并在恢复过程中立即遇到 NU1608 警告。 他们进行调查，发现 条形码库 预期的 SkiaSharp 版本范围与 MAUI 要求的版本不匹配，添加显式的 <PackageReference> 覆盖以强制解决此问题，并使构建通过。 然后，当 SkiaSharp 的本地二进制文件加载了错误的版本时，设备运行时就会崩溃。 修复此问题需要对程序集绑定日志进行更深入的调查。 切换到IronBarcode可以从根本上消除冲突——不是通过找到兼容的 SkiaSharp 版本，而是通过完全消除共享依赖项。

需要进行PDF条形码处理

能够生成带有嵌入式条形码的 PDF 文档（例如发票、工作单、发货清单）的应用程序，有时需要在下游处理过程中读取这些条形码。 条形码库 可以生成条形码图像，但两端均不支持 PDF。 使用 条形码库 从 PDF 中读取条形码需要先使用单独的 PDF 库将 PDF 渲染成图像，然后将这些图像传递给单独的读取库。IronBarcode原生处理整个链：BarcodeReader.Read("file.pdf") 遍历每一页并返回所有检测到的条形码，而无需中间渲染步骤。

二维码功能超越了基础一代

最初只需要生成基本二维码的项目，往往会发展到需要嵌入徽标、颜色自定义或纠错级别配置。 条形码库 支持通过 TYPE.QR_Code 编码的二维码，但除了标准的 Width、Height 和 IncludeLabel 属性之外，没有提供其他选项。IronBarcode的 QRCodeWriter 通过链式方法公开徽标嵌入、颜色控制和纠错调整。 对于那些二维码需求超出 条形码库 基本实现支持范围的团队来说，功能差距是促使他们做出迁移决定的主要因素。

实例 API 到静态 Fluent API

BarcodeLib 代码使用可变对象模式：创建一个 Barcode 实例，设置属性，调用 Encode()。IronBarcode使用静态流畅模式：调用 BarcodeWriter.CreateBarcode()，链接配置方法，以输出方法结束。 将 Barcode 实例存储为字段或在方法之间传递该实例的现有代码需要进行重构。 典型的改动是用方法链替换属性设置器代码块：

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddAnnotationTextBelowBarcode(data)
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddAnnotationTextBelowBarcode(data)
    .SaveAsPng(outputPath);

系统绘图图像到直接输出

BarcodeLib 返回 System.Drawing.Image，需要 MemoryStream 来生成字节。 任何输入到 Image 或 System.Drawing.Image 的代码都需要更新。IronBarcode的流畅链直接以所需的输出格式结束 — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — 无需中间图像对象和 MemoryStream 步骤。

TYPE Enum to BarcodeEncoding Enum

BarcodeLib 使用 TYPE 类，其中常量为大写，例如 TYPE.CODE128。IronBarcode使用 BarcodeEncoding 枚举，其 PascalCase 值如 BarcodeEncoding.Code128。 数值直接对应。 在 .cs 文件中使用 grep 命令查找 TYPE\.，即可识别所有需要更新的实例，然后通过系统性的查找和替换来覆盖常见格式：CODE128 → Code128，EAN13 → EAN13，UPCA → UPCA，QR_Code → QRCode。

SkiaSharp 参考清理

仅为了解决 条形码库 的 NU1608 警告而添加显式 <PackageReference Include="SkiaSharp"> 条目的项目，在切换到IronBarcode后可以删除这些覆盖项。 dotnet list package --include-transitive 命令用于确认 SkiaSharp 是否仍被项目中的其他软件包所需要，然后再将其删除。