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")       ' CS1061: no definition
' Dim value = b.Scan("barcode.png")         ' CS1061: no definition
' Dim value = b.ReadBarcode("barcode.png")  ' CS1061: 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。 條碼庫 綁定到特定的 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 → @@--CODE-93399--DE-93399--DE-4 EAN13，UPCA → UPCA，QR_Code → QRCode。

SkiaSharp 參考清理

僅為了解決 條碼庫 的 NU1608 警告而添加明確 <PackageReference Include="SkiaSharp"> 條目的項目，在切換到IronBarcode後可以刪除這些覆蓋項。 dotnet list package --include-transitive 指令用於確認 SkiaSharp 是否仍被專案中的其他軟體包所需要，然後再刪除。