python部署可離線使用的中文識別OCR(window)

更新時間：2025年10月16日 09:00:46 作者：oCy

日常很多應用、小程序都提供有文字識別功能,導致不少項目業(yè)主也會提這方面需求,本篇將分享python自帶的可離線使用的中文識別（cnocr）環(huán)境的搭建,希望對大家有所幫助

前言

日常很多應用、小程序都提供有文字識別功能，導致不少項目業(yè)主也會提這方面需求，但在線就意味著付費，本人在前面分享過一個在線調用百度OCR識別表格的應用工具也是付費的（一天免費調用50次，只夠做免費調研），本篇將分享python自帶的可離線使用的中文識別（cnocr）環(huán)境的搭建。

概述

之所以選擇python，是因為python上有很多封裝好的人工智能模塊，通過簡單的在線下載即可完成環(huán)境的搭建。

環(huán)境搭建

1、下載python

安裝cnocr必須在python 3.8版本以上，本篇使用的是python 3.8.10。下載地址：

https://registry.npmmirror.com/binary.html?path=python/3.8.10/

64位window選擇python-3.8.10-amd64.exe（python是吃性能的，如果用window作為服務器端部署，建議還是得用64位的系統(tǒng)）

2、創(chuàng)建python虛擬環(huán)境

裝完python之后，如果只是體驗，是可以不需要創(chuàng)建虛擬環(huán)境的，但下一篇我會分享怎么把python程序打包成.exe程序，使用虛擬環(huán)境才能達到“瘦身”效果。

python虛擬環(huán)境會以目錄形式存在，我把虛擬環(huán)境放在D:\python目錄下。

打開cmd命令窗口，進入D:\python目錄，執(zhí)行以下命令創(chuàng)建并激活虛擬環(huán)境

# 創(chuàng)建虛擬環(huán)境
python -m venv cnocr_env

# 激活虛擬環(huán)境
cnocr_env\Scripts\activate

激活之后，如下圖，在目錄前面有虛擬環(huán)境的標識

3、升級pip

安裝python3.8.10自帶安裝的pip不是最新版本的，無法下載cnocr，更新命令如下：

python -m pip install --upgrade pip
#如果以上命令報錯就執(zhí)行下面的命令
python -m pip install --upgrade pip --force-reinstall

執(zhí)行命令如果有問題，需要多執(zhí)行幾次。

4、安裝 CnOCR

要關聯(lián)下載的東西比較多，官網(wǎng)安裝容易中斷，下面用國內的鏡像

pip install cnocr -i https://pypi.tuna.tsinghua.edu.cn/simple

5、寫代碼測試

我在虛擬場景下創(chuàng)建了core目錄存放python代碼，代碼內容如下

from cnocr import CnOcr
print('============1===========')
ocr=CnOcr()
print('============2===========')
result=ocr.ocr('./123.png')
print('============3===========')
print(result)

首次運行會報錯未發(fā)現(xiàn)"onnxruntime"模塊，onnxruntime是一個用于運行 ONNX（Open Neural Network Exchange）模型的 ??高性能推理引擎??。它是 Python 的一個模塊，專門用于在各種硬件平臺上高效地執(zhí)行深度學習模型。

6、安裝onnxruntime

pip install onnxruntime -i https://mirrors.aliyun.com/pypi/simple/

下載完成后，自動下載了一個訓練好的模型ch_PP-OCRv5_det_infer.onnx，重新運行測試程序，可以看到有信息提示：

[INFO] 2025-10-15 18:06:41,321 [RapidOCR] base.py:22: Using engine_name: onnxruntime
[INFO] 2025-10-15 18:06:41,337 [RapidOCR] main.py:53: Using C:\Users\xxxx\AppData\Roaming\cnstd\1.2\ppocr\ch_PP-OCRv5_det\ch_PP-OCRv5_det_infer.onnx

如下圖所示，可以在提示的目錄中找到ch_PP-OCRv5_det_infer.onnx

篇尾

以上安裝的cnocr包含的ch_PP-OCRv5_det_infer.onnx模型，是百度飛槳（PaddlePaddle）框架的OCR工具庫PaddleOCR最新的文本檢測模型之一，百度的AI接口平臺也是基于PaddlePaddle提供的AI模型范圍，所以準確度是有保障的，符合離線部署需求場景。

另外也分享下基于PaddleOCR的一個離線exe應用，功能比較豐富

https://gitcode.com/GitHub_Trending/um/Umi-OCR?source_module=search_result_repo