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

多包生成工作流程

安装过程立刻就能说明范围上的差异。 使用 条形码 时，基本的 PNG 输出需要两个单独的软件包：

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

生成 Code128 条形码并将其保存为 PNG 格式的完整工作流程需要三个命名空间导入、一个特定格式的编码器调用、一个带有选项对象的渲染器构造、一个文件流和一个渲染调用：

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

切换条形码格式不是参数更改——它需要导入不同的命名空间并调用不同的类。 Code128Encoder.Encode 接受一个布尔值，includeChecksum，QrEncoder.Encode 接受一个纠错级别和两个附加的布尔值，而 DataMatrixEncoder.Encode 只接受一个字符串。 目前还没有统一的界面来创建指定格式的条形码。

详细功能对比

条形码方法

条形码器通过不同命名空间中的不同编码器类来选择格式。 切换格式意味着添加一个新的 using 指令，并使用具有不同方法签名的不同类：

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

每个编码器都有自己的参数合约。 向现有项目中添加新格式并非简单的文字更改——它需要导入新的命名空间、学习新的类并理解新的参数。

IronBarcode方法

IronBarcode 通过统一的 BarcodeWriter 类上的 BarcodeEncoding 枚举路由所有格式选择。 添加新格式只需对枚举值进行一个单词的更改：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

生产环境使用时，请在应用程序启动时添加许可证密钥：

IronBarCode.License.LicenseKey = "YOUR-KEY";

IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

IronBarcode条形码生成文档涵盖了所有生成选项，包括样式、边距和颜色自定义。

条形码方法

Barcoder 将编码与渲染分离的架构理念是合理的，但每次输出格式更改都会产生额外的开销。 保存到文件需要打开 FileStream。 获取二进制数据需要打开一个 MemoryStream 并调用 ToArray()。 每种输出场景都需要构建一个带有选项对象的渲染器：

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

尺寸控制是间接的：PixelSize 是条形码模块尺寸的缩放倍数，而不是直接的宽度和高度规格。

IronBarcode方法

IronBarcode 返回一个 GeneratedBarcode 对象，可以通过链式方法调用访问任何输出形式。 无需渲染器构建，无需流管理：

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height) 接受显式像素尺寸，并与同一对象上的任何输出方法链接。

条形码方法

条形码器不具备读取或解码功能。 目前没有 API，也没有计划推出 API，库中也没有任何变通方法。 如果应用程序需要读取条形码，则必须将第二个库（一个单独的NuGet依赖项，具有自己的 API 接口和自己的版本跟踪）与 条形码 一起添加。 这意味着至少需要两个与读取相关的依赖项：用于生成的条形码，以及用于读取的其他东西。

IronBarcode方法

IronBarcode使用同一软件包和一致的 API 模式，同时支持条码生成和读取。 BarcodeReader.Read() 方法原生支持图像文件、字节数组、流和 PDF 文件：

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// 从PDF文件阅读 — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// 从PDF文件阅读 — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine(result.Value)
    Console.WriteLine(result.Format)
Next

' 从PDF文件阅读 — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

读取 PDF 文件是原生操作——无需中间图像提取、转换库或额外软件包。 IronBarcode条形码读取文档涵盖多页 PDF、感兴趣区域读取和性能调优。

阅读被列入要求中。

许多项目最初都是纯粹的生成流程——打印标签、生成文档代码、在报告中嵌入条形码。 条形码 为这些项目提供初始支持。 当同一个应用程序稍后需要验证传入的条形码、处理扫描的文档或解码上传的 PDF 中的条形码时，Barcoder 无法提供任何解决方案。 团队必须评估第二个库，了解其 API，单独管理其NuGet版本，并处理两个库之间的集成接口。 达到这一步的团队通常会合并到一个可以处理双方的库中，而不是维护两个独立的条形码依赖项。

.NET Framework兼容性中断

Barcoder.Renderer.Image 已放弃对.NET Framework的支持。 在.NET Framework 4.x 上维护服务或桌面应用程序的团队，如果在例行依赖项维护期间更新图像渲染器包，则会遇到生成失败。 这不是配置错误——这是库的平台支持决定。 IronBarcode支持.NET Framework 4.6.2 至.NET 9，无需针对不同目标进行特殊打包或条件依赖。

软件包版本漂移导致协调问题

由于 Barcoder 和 Barcoder.Renderer.Image 是独立版本化的，在依赖项刷新期间，如果只更新其中一个而不更新另一个，可能会引入细微的不兼容性。 在一个包含多个项目的存储库中——每个项目都使用不同版本的渲染器包——确保跨项目的行为一致就变成了一个协调问题，而且这个问题会随着团队规模的扩大而加剧。 使用IronBarcode整合团队后发现，管理一个软件包和一个版本可以彻底消除此类问题。

格式覆盖范围随时间推移而扩大

一个项目可能从 Code128 标签开始，之后添加二维码作为面向客户的链接，然后添加 DataMatrix 以满足合规性要求。 使用 条形码 时，每增加一种格式都意味着需要导入一个新的命名空间，一个具有不同方法参数的不同编码器类，并且可能需要一个新的NuGet包。 使用 IronBarcode，添加格式是对现有调用中 BarcodeEncoding 枚举值的更改。 对于计划扩展条形码格式覆盖范围的团队来说，基于枚举的模型更容易维护。

MAUI 和跨平台部署要求

Barcoder 没有提供对 MAUI、Docker、AWS Lambda 或 Azure 部署的支持文档。 构建跨平台 MAUI 应用程序或将条形码处理部署到无服务器基础架构的团队发现，Barcoder 的文档和测试并未涵盖这些目标。 IronBarcode文档并积极测试在 iOS、Android、Windows、macOS MAUI 目标、Docker 容器和主要云平台上的部署。

将 IBarcode 更改为 GeneratedBarcode 类型更改

存储 IBarcode 变量并将其传递给渲染器的条形码代码必须进行重构。 在IronBarcode中，GeneratedBarcode 有其自身的输出方法——没有单独的渲染步骤。任何当前接受 IBarcode 的方法签名都应该更改为接受 GeneratedBarcode，并且该方法内部的渲染调用应该改为直接调用，例如 .SaveAsPng() 或 .ToPngBinaryData()。 类型系统会在编译期间显示所有需要更新的位置——在移除 条形码 包后，IBarcode 将无法解析。

PixelSize 没有直接等效项

条形码的 PixelSize 是条形码自然模块尺寸的缩放倍数，而不是明确的像素尺寸。 输出宽度取决于条形码内容、格式和倍数的组合。IronBarcode使用 .ResizeTo(width, height)，并明确指定像素尺寸。 迁移过程中，测量现有条形码代码实际输出的尺寸，并在 .ResizeTo() 调用中使用这些值：

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

命名空间合并

条形码项目会累积 using Barcoder.* 语句——每个使用的格式一个语句。 在迁移过程中，所有这些都合并为一个 using IronBarCode;。 在解决方案中搜索 using Barcoder 将找到所有需要更新的文件。 受影响的文件数量通常比团队预期的要多，因为每个涉及条形码格式的文件都会导入其自身特定于格式的命名空间。

SVG 输出路径更改

使用 Barcoder.Renderer.Svg 和 SvgRenderer 类的项目将渲染器管道替换为对 GeneratedBarcode 的直接方法调用：

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

所有 SVG 渲染站点迁移完毕后，即可删除 Barcoder.Renderer.Svg 软件包。