二维码已成为现代应用的常见组成部分，广泛应用于用户身份验证、移动支付、商品包装和活动票务等场景。很多使用 C# 开发的系统需要从图像或扫描件中提取二维码信息，因此掌握二维码识别技术显得尤为重要。
为满足这类需求，开发者需要一种既可靠又易于集成的二维码解码方式。本文将通过一个简洁明了的示例，演示如何使用 C# 从图像中读取二维码，并在桌面或服务器端项目中轻松实现识别功能。
快速导航
1. 项目配置
首先我们需要使用支持二维码解码的 .NET 条码库。本指南采用 Spire.Barcode for .NET，该库提供简洁API帮助开发者轻松从图片文件和数据流读取二维码。
1.1 通过NuGet安装库
可通过NuGet包管理器安装：
Install-Package Spire.Barcode
对于简单的项目，也可使用免费版 Free Spire.Barcode for .NET：
Install-Package FreeSpire.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 参数确保仅检测二维码（可修改为其他类型）
- 返回数组格式以支持多二维码场景
扩展阅读：使用 C# 生成二维码
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 等需要内存处理的应用。
相关教程：用 C# 从 PDF 读取条码
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 程序，且配置简单性能优异。
基于此基础，可进一步探索二维码生成、文档集成和实时扫描等进阶应用。申请免费临时授权，即可体验 Spire.Barcode for .NET 全功能无限制版本。
