NetBarcode 与 IronBarcode：C# 条码库对比

枚举类型设计边界

Type 枚举是 NetBarcode 可以生成的权威列表。 检查它可知该库的范围：

// NetBarcode Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

// NetBarcode Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

Public Enum Type
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39Extended
    Code93
    EAN8
    EAN13
    UPCA
    UPCE
    Codabar
    ITF
    MSI
End Enum

' These entries do not exist — attempting to use them produces a BC30456 compile error:
' Type.QRCode      — does not exist
' Type.DataMatrix  — does not exist
' Type.PDF417      — does not exist
' Type.Aztec       — does not exist

这并非待提交 pull request 的缺失功能。枚举类型包含十四个条目，全部为一维类型，这符合库的预期范围。 任何需要 QR 码、DataMatrix、PDF417 或 阿兹特克 格式的应用都必须单独获取相应的软件包。

详细功能对比

NetBarcode 方法

NetBarcode 通过 Type 枚举提供 14 种线性条形码格式。 在这个范围内，格式选择很简单——将相应的枚举成员传递给构造函数即可。 界限同样清晰：尝试使用枚举范围之外的格式会产生编译时错误。

// NetBarcode — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// NetBarcode — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

// NetBarcode — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// NetBarcode — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

Imports NetBarcode

Dim code128 As New Barcode("12345678901234", Type.Code128)
code128.SaveImageFile("shipping.png")

Dim ean13 As New Barcode("5901234123457", Type.EAN13)
ean13.SaveImageFile("product.png")

' NetBarcode — formats that produce CS0117 compile errors
' Dim qr As New Barcode("data", Type.QRCode)     ' error CS0117
' Dim dm As New Barcode("data", Type.DataMatrix) ' error CS0117
' Dim p417 As New Barcode("data", Type.PDF417)   ' error CS0117
' Dim aztec As New Barcode("data", Type.Aztec)   ' error CS0117

在某些行业，这种边界会成为一种限制，例如药品追踪（根据 FDA 2D 条形码规定需要使用 DataMatrix）、航空公司登机牌（Aztec）、物流清单（PDF417）和移动营销（二维码）。 这些要求都使得 NetBarcode 无法作为独立解决方案使用。

开始使用 IronBarcode 是一个专为 .NET 框架设计的条码读取和写入库。方法

IronBarcode 通过相同的 BarcodeWriter.CreateBarcode 方法公开所有支持的格式。 从 1D 格式过渡到 2D 格式时，API 界面不会改变——只有 BarcodeEncoding 常量有所不同。

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

Imports IronBarCode

' 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product.png")

' 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec) _
    .SaveAsPng("boarding-pass.png")

支持的常量完整列表可在支持的条形码格式参考中找到，涵盖所有二维条形码生成格式以及完整的 1D 条形码集。

NetBarcode 方法

NetBarcode 的生成模型是基于构造函数的。 使用数据字符串和枚举值实例化一个 Barcode 对象。 输出可以直接保存为 SaveImageFile()，也可以通过 GetImage() 以 Image<Rgba32> 的形式检索。 自 1.8 版本起，GetImage() 的返回类型为 SixLabors.ImageSharp 类型，这意味着任何存储或处理返回值的代码都必须导入 ImageSharp API 并在其中运行。

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

Imports NetBarcode
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats
Imports System.IO

' Constructor-based creation
Dim barcode As New Barcode("12345678901234", Type.Code128)

' Save to file — straightforward
barcode.SaveImageFile("code128.png")

' GetImage() returns Image(Of Rgba32) — ImageSharp import required
Dim image As Image(Of Rgba32) = barcode.GetImage()

' Further processing requires familiarity with the ImageSharp API
Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

GetImage() 方法的返回类型将下游代码与 ImageSharp 库关联起来。 任何接受或存储结果的方法都必须将其声明为 Image<Rgba32>，从而向调用代码引入传递依赖。

开始使用 IronBarcode 是一个专为 .NET 框架设计的条码读取和写入库。方法

IronBarcode使用流畅的链式架构。 BarcodeWriter.CreateBarcode 返回一个 GeneratedBarcode 对象，该对象包含多个输出方法。 图像处理是内部的——不会向调用代码公开 ImageSharp 类型。

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

' Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' Multiple output options on the same GeneratedBarcode object
Dim barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
barcode.SaveAsPng("code128.png")
barcode.SaveAsJpeg("code128.jpg")
Dim bytes As Byte() = barcode.ToPngBinaryData()

Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

IronBarcode文档中详细介绍了1D 条形码生成的选项，包括宽度、高度和标签配置。

NetBarcode 方法

NetBarcode没有读取API。 目前没有任何方法、类或配置可以将条形码图像解码回其数据字符串。 这是有意设定的范围界限，并非在发布前故意省略的内容。 使用 NetBarcode 生成条形码，之后需要读取条形码的项目（例如验证打印标签、扫描退货或从供应商发票中提取数值）必须为此目的引入单独的库。

// NetBarcode — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

// NetBarcode — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

' NetBarcode — no reading method exists
' The following does not compile because the method does not exist:
' Dim result = barcode.Read("image.png")  ' method does not exist

' The typical workaround requires ZXing.Net as a third-party dependency

ZXing .NET库是与 NetBarcode 一起读取时最常见的附加组件，它带来了第三个 API 接口和第三个软件包，需要与 NetBarcode 和任何已添加的二维码库一起进行版本管理。

开始使用 IronBarcode 是一个专为 .NET 框架设计的条码读取和写入库。方法

IronBarcode 将 BarcodeReader 包含在与 BarcodeWriter 相同的软件包中。 读取 API 接受图像文件和 PDF 文档，并返回一组解码结果，每个结果都包含条形码值、格式类型和页码（如果是从 PDF 读取）。

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

Imports IronBarCode

' Read barcodes from an image file
Dim imageResults = BarcodeReader.Read("shipping-label.png")
For Each r In imageResults
    Console.WriteLine($"{r.BarcodeType}: {r.Value}")
Next

' Read barcodes from a PDF document — no additional library required
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

从图像读取条形码指南涵盖了读取 API 中提供的速度调整、多条形码检测和图像校正选项。

NetBarcode 和 ImageSharp

NetBarcode 采用麻省理工学院许可证。 它所依赖的 SixLabors.ImageSharp 库采用不同的模式：对于开源项目和年总收入低于规定阈值的公司是免费的，但超过该阈值则需要商业许可。 无论 ImageSharp 是否在项目的 .csproj 中明确列出，还是通过 NetBarcode 传递过来，此拆分均适用。

<PackageReference Include="NetBarcode" Version="1.8.2" />

<PackageReference Include="NetBarcode" Version="1.8.2" />

对于大规模处理条形码的零售或物流公司（NetBarcode 的主要目标用例）而言，其年收入通常高于 ImageSharp 商业许可适用的门槛。 合规性审计可能会揭示出软件包树中蕴含的这项义务。

v1.8 版本引入了 ImageSharp 依赖项的另一个后果：GetImage() 的返回类型从内部表示变为 SixLabors.ImageSharp.Image<Rgba32>。 现有代码在没有显式类型的情况下调用 GetImage()，导致编译时出错，因此需要为 SixLabors.ImageSharp 和 SixLabors.ImageSharp.PixelFormats 添加新的 using 指令。 当 ImageSharp 自身的 API 在未来的版本中不断发展时，NetBarcode 的公共 API 接口也会受到影响。

开始使用 IronBarcode 是一个专为 .NET 框架设计的条码读取和写入库。

IronBarcode不依赖于 SixLabors.ImageSharp。 其许可条款直接在IronBarcode许可页面上列明，没有拆分门槛或传递商业义务。 提供试用密钥供评估； 购买的许可证可以移除生成输出中的试用水印。

二维码和二维格式要求

评估 NetBarcode 替代方案的最常见触发因素是对二维码的新需求。 最初为零售标签或货运清单生成一维条形码的应用，通常会有后续需求生成二维码——非接触式链接、移动应用深度链接、营销活动。 因为 Type 枚举没有 QR 条目，所以 NetBarcode 无法满足此要求。 如果团队添加单独的 QR 库来弥补差距，那么在制药集成需要 数据矩阵 或物流承运商要求在运输标签上使用 PDF417 时，他们将面临第二次评估。

条形码读取变得必不可少

有些项目从纯粹的生成开始，后来又增加了验证或文档处理要求：确认打印的条形码与其源数据匹配，从供应商发票中提取条形码值，或扫描退货标签。 NetBarcode 没有提供此路径。 添加 ZXing .NET或类似的读取库，会在同一个代码库中引入第三个需要学习和维护的 API，该代码库已经包含 NetBarcode 和 QR 库。 即使在未来的阶段，如果项目需要满足阅读需求，那么选择一个从一开始就能解决这两个问题的图书馆通常会更加高效。

ImageSharp商业许可审核

对第三方依赖项的法律和合规性审查有时会发现 NetBarcode 软件包树中嵌入的 SixLabors.ImageSharp 商业许可条件。 对于年总收入超过门槛的公司，无论 ImageSharp 是有意选择还是通过 NetBarcode 间接获得，都适用该义务。 如果团队在审计过程中（而不是在采用之前）发现这个问题，则需要进行追溯性补救，而不是计划性迁移。 在项目启动前评估依赖项许可证是更明智的做法。

降低多库复杂性

已经积累了用于生成一维条码的 NetBarcode、用于二维输出的 QR 专用库以及用于读取的 ZXing .NET的团队发现，他们需要在三个不同的软件包之间保持版本兼容性。 每次升级周期都需要检查这三个库是否对其共享的 ImageSharp 版本达成一致。 项目中的每个新开发人员都会遇到三个不同的 API，而这些 API 从概念上讲都是同一个问题。 将条码库整合为一个单一的条码库，可以简化上线流程，减少版本冲突，并将维护工作集中在一个发布周期内。

包交换和传递依赖清理

第一步是移除 NetBarcode（dotnet remove package NetBarcode）。如果项目中的其他包也间接引入了 SixLabors.ImageSharp 包，那么它可能会重新出现在依赖关系树中。 删除后，使用 dotnet list package --include-transitive 检查恢复的软件包列表，以确认 ImageSharp 是否仍然存在，以及其商业许可条件是否仍然适用。

GetImage() 返回类型替换

任何将 GetImage() 的结果存储为 Image<Rgba32> 的代码都必须更新。 ImageSharp 类型在IronBarcode中没有直接对应的类型； 替换方式取决于图像在下游的用途。 将图像保存到流中的代码可以直接替换为 .SaveAsPng(stream) 对象上的 GeneratedBarcode 。 检索原始字节的代码可以使用 .ToPngBinaryData()。 对返回的图像执行进一步 ImageSharp 操作的代码需要单独评估这些操作。

命名空间更新

导入了 using NetBarcode;、using SixLabors.ImageSharp;、using SixLabors.ImageSharp.PixelFormats; 或 using SixLabors.Fonts; 的文件需要将这些指令替换为 using IronBarCode;。 在项目范围内搜索这些 using 语句，可以识别出在尝试构建之前需要注意的每个文件。