現代商業系統高度依賴條形碼掃描功能，從零售收銀通道到倉庫庫存追蹤皆是如此。如今，強大的編程庫使得將這一核心功能集成到定制化軟件解決方案中變得異常簡單。其中，基于 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 完成此操作。打開終端并運行以下命令：

pip install spire.barcode

安裝庫后，您需要一個許可證密鑰來解鎖全部功能。您可以從我們的官網獲取試用許可證。獲得許可證密鑰后，在 Python 腳本中設置庫：

from spire.barcode import *

# 應用許可證密鑰以解鎖全部功能
License.SetLicenseKey("your license key")

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)

代碼說明

• 條碼類型(BarcodeType)：精確指定待識別的條碼格式，可有效減少誤識別。
• 校驗和驗證(IncludeCheckSum)：確定在掃描過程中是否驗證校驗和。將其設置為 True 可以幫助捕捉數據中的錯誤；設置為 False 則可跳過驗證，提升識別速度。

總結

本文詳細介紹了如何使用 Spire.Barcode 庫在 Python 中實現條形碼識別功能，內容包括：

• 環境配置與庫安裝
• 單條碼/批量條碼的圖像文件識別
• 內存字節流的條碼解析方案
• 通過參數定制提升識別精度的技巧

 掌握這些方法后，您可輕松為 Python 應用程序集成專業的條碼掃描能力。 

常見問題解答

Q1: 我可以使用 Spire.Barcode 讀取哪些類型的條形碼？

Spire.Barcode 支持多種條形碼格式，包括 QR 碼、UPC、EAN、Code 128、Code 39 等。

Q2: 我需要許可證才能使用 Spire.Barcode 嗎？

是的，您需要許可證密鑰以解鎖庫的全部功能。 

Q3: 我可以使用 Spire.Barcode 從網絡攝像頭讀取條形碼嗎？

雖然 Spire.Barcode 不直接支持網絡攝像頭輸入，但您可以從網絡攝像頭捕獲圖像，然后使用該庫從這些圖像中讀取條形碼。 

Q4: 如何提高條形碼掃描的準確性？

您可以通過指定條形碼類型和在掃描過程中啟用校驗和驗證來提高準確性。此外，確保圖像足夠清晰。

Q5: 我可以使用 Spire.Barcode for Python 生成條形碼嗎？

是的，Spire.Barcode 支持條形碼識別和生成。

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

關于慧都科技：

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

歡迎下載|體驗更多E-iceblue產品