二維碼已成為現(xiàn)代應用的常見組成部分，廣泛應用于用戶身份驗證、移動支付、商品包裝和活動票務等場景。很多使用 C# 開發(fā)的系統(tǒng)需要從圖像或掃描件中提取二維碼信息，因此掌握二維碼識別技術顯得尤為重要。

為滿足這類需求，開發(fā)者需要一種既可靠又易于集成的二維碼解碼方式。本文將通過一個簡潔明了的示例，演示如何借助 Spire.Barcode for .NET 使用 C# 從圖像中讀取二維碼，并在桌面或服務器端項目中輕松實現(xiàn)識別功能。

   Spire.Barcode for .NET

加入Spire技術交流QQ群（125237868），與更多開發(fā)者一起提升文檔開發(fā)技能。

1. 項目配置

首先我們需要使用支持二維碼解碼的 .NET 條碼庫。E-iceblue旗下Spire系列產(chǎn)品是國產(chǎn)化文檔處理和轉換領域的佼佼者，支持國產(chǎn)化信創(chuàng)。本指南采用 Spire.Barcode for .NET，該庫提供簡潔API幫助開發(fā)者輕松從圖片文件和數(shù)據(jù)流讀取二維碼。

1.1 通過NuGet安裝庫

可通過NuGet包管理器安裝：

Install-Package Spire.Barcode

1.2 創(chuàng)建控制臺項目

演示案例使用 Visual Studio 創(chuàng)建 C# 控制臺應用：

• 支持 .NET Framework、.NET Core/.NET 6+、ASP.NET 或 Xamarin 跨平臺移動開發(fā)
• 添加 Spire.Barcode.dll 引用（如未使用NuGet）

2. 用 C# 從圖片讀取二維碼

通過庫提供的靜態(tài)方法 BarcodeScanner.Scan() 即可從圖片文件讀取二維碼。該方法接收圖片路徑和 BarcodeType 作為參數(shù)，返回匹配指定類型（如二維碼）的所有解碼結果。此方法支持 JPG、PNG、EMF 等圖片格式，適用于控制臺應用、桌面應用或處理上傳圖像的服務端程序。

2.1 C# 示例代碼：從圖片文件解碼二維碼

using Spire.Barcode;

class Program
{
    static void Main(string[] args)
    {
        // 加載二維碼圖片
        string imagePath = @"C:\qr-code.png";

        // 條碼掃描器從圖片讀取二維碼
        string[] results = BarcodeScanner.Scan(imagePath, BarCodeType.QRCode);

        // 顯示解碼結果
        foreach (string result in results)
        {
            Console.WriteLine("二維碼內(nèi)容: " + result + "\n");
        }
    }
}

二維碼圖片及 C# 解碼效果：

2.2 代碼說明

• Scan() 方法讀取并解碼圖片中所有條碼
• BarCodeType.QRCode 參數(shù)確保僅檢測二維碼（可修改為其他類型）
• 返回數(shù)組格式以支持多二維碼場景

3. 用 C# 從數(shù)據(jù)流讀取二維碼

在Web API或現(xiàn)代應用中處理內(nèi)存圖像時，常需操作 Stream 對象——例如處理文件上傳或讀取云存儲時。

BarcodeScanner.Scan() 方法直接支持 Stream 輸入，無需轉換即可輕松解碼二維碼：

using Spire.Barcode;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        using (FileStream fs = new FileStream(@"C:\qr-code.png", FileMode.Open, FileAccess.Read))
        {
            // 直接從數(shù)據(jù)流解析二維碼
            string[] results = BarcodeScanner.Scan(fs, BarCodeType.QRCode, false);
            foreach (string result in results)
            {
                Console.WriteLine("二維碼內(nèi)容: " + result);
            }
        }
    }
}

4. 提高準確率與錯誤處理

實際場景中可能因圖像質量導致識別失敗，以下是提升解碼成功率的實踐方案：

4.1 優(yōu)化識別準確率

• 使用高清圖片，避免模糊或過度壓縮
• 保留靜區(qū)（二維碼周圍空白區(qū)域）
• 優(yōu)先選擇PNG格式保證清晰度
• 避免透視畸變——使用正對拍攝的圖片

4.2 增強錯誤處理

通過 try-catch 塊優(yōu)化異常處理：

try
{
    string[] results = BarcodeScanner.Scan(imagePath, BarCodeType.QRCode);

    if (results.Length == 0)
    {
        Console.WriteLine("未檢測到二維碼");
    }
    else
    {
        Console.WriteLine("二維碼內(nèi)容: " + results[0]);
    }
}
catch (Exception ex)
{
    Console.WriteLine("解碼錯誤: " + ex.Message);
}

5. 進階技巧：獲取二維碼在圖片上的坐標

有時需要獲取二維碼在圖片中的精確位置（用于裁剪或標注），可通過 ScanInfo() 方法獲取邊界框：

ScanResult[] results = scanner.ScanInfo(imagePath, BarCodeType.QRCode);
foreach (BarcodeInfo result in results)
{
    Console.WriteLine("內(nèi)容: " + result.DataString);
    Console.WriteLine($"坐標: " + string.Join(",", result.Vertexes.Select(p => $"({p.X},{p.Y})")) + "\n");
}

該方案可同時獲取二維碼數(shù)據(jù)和位置信息。

效果演示：

6. 常見問題

如何在 C# 中讀取二維碼？

使用 Spire.Barcode for .NET 庫的 BarcodeScanner.Scan() 方法，幾行代碼即可實現(xiàn)從圖片或數(shù)據(jù)流讀取二維碼。

如何讀取其他類型條碼（非二維碼）？

向 Scan() 方法傳入圖片路徑后，將自動檢測所有支持類型。若需限定檢測類型（如僅 QR 碼或 Code128），傳入對應的 BarCodeType 參數(shù)即可。

如何掃描一張圖片上的多個二維碼？

直接使用 BarcodeScanner.Scan() 方法即可掃描一張圖片上的多個二維碼。該方法支持自動識別圖片上條碼的類型，并返回所有條碼的掃描結果。

7. 總結

使用 Spire.Barcode for .NET 庫，僅需少量代碼即可在 C# 中實現(xiàn)二維碼讀取。該方案支持圖片和數(shù)據(jù)流解碼，完美適配桌面應用、服務端及 WPF 程序，且配置簡單性能優(yōu)異。

基于此基礎，可進一步探索二維碼生成、文檔集成和實時掃描等進階應用。  

————————————————————————————————————————

關于慧都科技：

慧都科技是一家行業(yè)數(shù)字化解決方案公司，長期專注于軟件、油氣與制造行業(yè)。公司基于深入的業(yè)務理解與管理洞察，以系統(tǒng)化的業(yè)務建模驅動技術落地，幫助企業(yè)實現(xiàn)智能化運營與長期競爭優(yōu)勢。在軟件工程領域，我們提供開發(fā)控件、研發(fā)管理、代碼開發(fā)、部署運維等軟件開發(fā)全鏈路所需的產(chǎn)品，提供正版授權采購、技術選型、個性化維保等服務，幫助客戶實現(xiàn)技術合規(guī)、降本增效與風險可控。慧都科技E-iceblue的官方授權代理商，提供E-iceblue系列產(chǎn)品免費試用，咨詢，正版銷售等于一體的專業(yè)化服務。E-iceblue旗下Spire系列產(chǎn)品是國產(chǎn)文檔處理領域的優(yōu)秀產(chǎn)品，支持國產(chǎn)化，幫助企業(yè)高效構建文檔處理的應用程序。

歡迎下載|體驗更多E-iceblue產(chǎn)品