国产化条码类库Spire.Barcode教程：如何使用 Python 读取条形码（从图像文件或字节流）-牛翰网

现代商业系统高度依赖条形码扫描功能，从零售收银通道到仓库库存追踪皆是如此。如今，强大的编程库使得将这一核心功能集成到定制化软件解决方案中变得异常简单。其中，基于 Python 的实现方案因其多功能性和易用性而格外受欢迎。

本文将介绍如何使用 Spire.Barcode for Python 库 在 Python 中读取条形码，该库提供了简单易用的条形码扫描API。文章涵盖库的安装配置、从图像文件及字节流中读取条形码、设置自定义识别选项等全方位内容。

Spire.Barcode for .NET正版免费试用，请联系慧都科技

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

Python 条形码识别库

Spire.Barcode for Python 是一款专为 Python 应用程序设计的强大条形码生成与读取库，凭借其丰富的功能和易用的接口脱颖而出。该库支持多种条形码格式，包括：

一维条形码：如 Code 128、Code 39、EAN-13 和 UPC-A。
二维条形码：包括 QR 码、DataMatrix 和 PDF417。

Spire.Barcode 的核心特性：

多格式支持：可从 PNG、JPG、BMP、GIF 和 TIFF 等多种图像格式中读取条形码。
批量扫描：支持单张图像内多个条形码的批量识别。
高精度识别：采用先进算法，确保稳定可靠的条形码检测。
灵活定制：允许用户指定条形码类型并启用校验和验证，以提升识别效率。

该库不仅支持从图像和流中读取条形码，还提供丰富的自定义选项，满足多样化的应用需求。

将 Spire.Barcode 集成到Python 应用程序

要开始使用 Spire.Barcode，首先需要安装该库，您可以通过 pip 完成此操作。打开终端并运行以下命令：

Spire.Barcode for .NET正版免费试用，请联系慧都科技

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

pip install spire.barcode

安装库后，您需要一个许可证密钥来解锁全部功能。您可以从我们的官网获取试用许可证。获得许可证密钥后，在 Python 脚本中设置库：

from spire.barcode import *

# 应用许可证密钥以解锁全部功能
License.SetLicenseKey("your license key")

现在库已准备就绪，您就可以开始使用 Python 读取条形码了。

Python 从图像文件中读取条形码

使用 Spire.Barcode 从图像文件中读取单个条形码非常简单，具体操作如下：

from spire.barcode import *

# 应用许可证密钥以解锁全部功能
License.SetLicenseKey("your license key")

# 从图像文件读取单个条形码
result = BarcodeScanner.ScanOneFile("C:/Users/Administrator/Desktop/qr_code.png")

# 打印结果
print(result)

代码说明

License.SetLicenseKey ：使用许可证密钥解除功能限制。
BarcodeScanner.ScanOneFile ：从指定图像文件中读取单个条形码。
输出结果 ：控制台将打印识别出的条形码数据。

效果图：

Python 从图像文件中读取多个条形码

若需从单个图像文件中读取多个条形码，Spire.Barcode同样能轻松实现。以下是具体示例：

from spire.barcode import *

# 应用许可证密钥以解锁全部功能
License.SetLicenseKey("your license key")

# 从文件读取多个条形码
results = BarcodeScanner.ScanFile("C:/Users/Administrator/Desktop/barcodes.jpg")

# 打印结果
print(results)

代码说明

BarcodeScanner.ScanFile：扫描整张图像以识别多个条形码
返回结果：以列表形式存储，每个元素包含一个检测到的条形码数据

效果图:

Python 从图像字节流中读取条形码

除了直接从文件中读取条形码，Spire.Barcode for Python 还支持从内存中的图像字节解码条形码，这种方案特别适用于处理动态加载的图像（如来自API接口、数据库或用户上传的场景）。

以下是实现方法：

from spire.barcode import *

# 应用许可证密钥以解锁全部功能
License.SetLicenseKey("your license key")

# 读取图像文件到内存
image_path = "C:/Users/Administrator/Desktop/barcodes.jpg"
with open(image_path, "rb") as file:
    image_bytes = file.read()

# 将字节流封装为 Spire.Barcode 的 Stream 对象中
stream = Stream(image_bytes)

# 从流中读取一个条形码
# result = BarcodeScanner.ScanOneStream(stream)

# 从流中读取多个条形码
results = BarcodeScanner.ScanStream(stream)

# 打印结果
print(results)

代码说明

image_bytes：从图像文件（如PNG/JPG）或API/数据库等来源获取的原始二进制数据。
Stream类：将图像字节流转换为Spire.Barcode兼容的内存流对象。
ScanStream方法：支持返回检测到的所有条形码列表。

条形码识别参数配置指南

Spire.Barcode 的 BarcodeScanner 类提供多种方法用于自定义识别参数，可显著提升检测精度和效率。核心配置方法包括：

ScanOneFileBarCodeTypeIncludeCheckSum(fileName: str, barcodeType: BarCodeType, IncludeCheckSum: bool)
ScanFileBarCodeTypeIncludeCheckSum(fileName: str, barcodeType: BarCodeType, IncludeCheckSum: bool)
ScanOneStreamBarCodeTypeIncludeCheckSum(stream: Stream, barcodeType: BarCodeType, IncludeCheckSum: bool)
ScanStreamBarCodeTypeIncludeCheckSum(stream: Stream, barcodeType: BarCodeType, IncludeCheckSum: bool)

应用示例（指定条码类型 + 校验和验证）

from spire.barcode import *

# 应用许可证密钥以解锁全部功能
License.SetLicenseKey("your license key")

# 指定条形码类型（例如，EAN13）
barcode_type = BarCodeType.EAN13

# 带校验和验证的条码扫描
result = BarcodeScanner.ScanOneFileBarCodeTypeIncludeCheckSum("C:/Users/Administrator/Desktop/EAN_13.png", barcode_type, True)

# 打印结果
print(result)

代码说明