国产化条码类库Spire.Barcode教程：使用 C# 读取二维

二维码已成为现代应用的常见组成部分，广泛应用于用户身份验证、移动支付、商品包装和活动票务等场景。很多使用 C# 开发的系统需要从图像或扫描件中提取二维码信息，因此掌握二维码识别技术显得尤为重要。

为满足这类需求，开发者需要一种既可靠又易于集成的二维码解码方式。本文将通过一个简洁明了的示例，演示如何借助 Spire.Barcode for .NET 使用 C# 从图像中读取二维码，并在桌面或服务器端项目中轻松实现识别功能。

获取Spire.Barcode for .NET免费试用，请联系Spire系列产品官方授权代理商慧都科技

加入Spire技术交流QQ群（125237868），与更多开发者一起提升文档开发技能。

1. 项目配置

首先我们需要使用支持二维码解码的 .NET 条码库。E-iceblue旗下Spire系列产品是国产化文档处理和转换领域的佼佼者，支持国产化信创。本指南采用 Spire.Barcode for .NET，该库提供简洁API帮助开发者轻松从图片文件和数据流读取二维码。

1.1 通过NuGet安装库

可通过NuGet包管理器安装：

Install-Package Spire.Barcode

1.2 创建控制台项目

演示案例使用 Visual Studio 创建 C# 控制台应用：

支持 .NET Framework、.NET Core/.NET 6+、ASP.NET 或 Xamarin 跨平台移动开发
添加 Spire.Barcode.dll 引用（如未使用NuGet）

2. 用 C# 从图片读取二维码

通过库提供的静态方法 BarcodeScanner.Scan() 即可从图片文件读取二维码。该方法接收图片路径和 BarcodeType 作为参数，返回匹配指定类型（如二维码）的所有解码结果。此方法支持 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("二维码内容: " + result + "\n");
        }
    }
}

二维码图片及 C# 解码效果：

2.2 代码说明

Scan() 方法读取并解码图片中所有条码
BarCodeType.QRCode 参数确保仅检测二维码（可修改为其他类型）
返回数组格式以支持多二维码场景

3. 用 C# 从数据流读取二维码

在Web API或现代应用中处理内存图像时，常需操作 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))
        {
            // 直接从数据流解析二维码
            string[] results = BarcodeScanner.Scan(fs, BarCodeType.QRCode, false);
            foreach (string result in results)
            {
                Console.WriteLine("二维码内容: " + result);
            }
        }
    }
}

此方法特别适用于 WPF 或 ASP.NET Core 等需要内存处理的应用。

4. 提高准确率与错误处理

实际场景中可能因图像质量导致识别失败，以下是提升解码成功率的实践方案：

4.1 优化识别准确率

使用高清图片，避免模糊或过度压缩
保留静区（二维码周围空白区域）
优先选择PNG格式保证清晰度
避免透视畸变——使用正对拍摄的图片

4.2 增强错误处理

通过 try-catch 块优化异常处理：

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

    if (results.Length == 0)
    {
        Console.WriteLine("未检测到二维码");
    }
    else
    {
        Console.WriteLine("二维码内容: " + 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("内容: " + result.DataString);
    Console.WriteLine($"坐标: " + string.Join(",", result.Vertexes.Select(p => $"({p.X},{p.Y})")) + "\n");
}

该方案可同时获取二维码数据和位置信息。

效果演示：

6. 常见问题

如何在 C# 中读取二维码？

使用 Spire.Barcode for .NET 库的 BarcodeScanner.Scan() 方法，几行代码即可实现从图片或数据流读取二维码。

如何读取其他类型条码（非二维码）？

向 Scan() 方法传入图片路径后，将自动检测所有支持类型。若需限定检测类型（如仅 QR 码或 Code128），传入对应的 BarCodeType 参数即可。

如何扫描一张图片上的多个二维码？

直接使用 BarcodeScanner.Scan() 方法即可扫描一张图片上的多个二维码。该方法支持自动识别图片上条码的类型，并返回所有条码的扫描结果。

7. 总结

使用 Spire.Barcode for .NET 库，仅需少量代码即可在 C# 中实现二维码读取。该方案支持图片和数据流解码，完美适配桌面应用、服务端及 WPF 程序，且配置简单性能优异。

基于此基础，可进一步探索二维码生成、文档集成和实时扫描等进阶应用。