PaddleOCR快速入门指南：从安装到实战应用-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01071/article/details/148324773

PaddleOCR快速入门指南：从安装到实战应用

PaddleOCR Awesome multilingual OCR toolkits based on PaddlePaddle (practical ultra lightweight OCR system, support 80+ languages recognition, provide data annotation and synthesis tools, support training and deployment among server, mobile, embedded and IoT devices) 项目地址: https://gitcode.com/gh_mirrors/pa/PaddleOCR

前言

PaddleOCR作为一款基于PaddlePaddle深度学习框架的OCR工具库，以其卓越的识别精度和丰富的功能特性，已成为业界领先的OCR解决方案。本文将带领初学者快速掌握PaddleOCR的安装部署和基本使用方法，涵盖文本检测、识别以及结构化文档处理等核心功能。

环境安装

1. 安装PaddlePaddle基础框架

PaddleOCR依赖于PaddlePaddle深度学习框架，因此需要先安装对应版本的PaddlePaddle。

CPU版本安装

适用于没有GPU设备的开发环境：

python -m pip install paddlepaddle==3.0.0

GPU版本安装

对于拥有NVIDIA GPU的设备，需要根据CUDA版本选择对应的安装包。以CUDA 11.8为例：

python -m pip install paddlepaddle-gpu==3.0.0

注意：GPU版本需要提前安装正确版本的CUDA和cuDNN，具体版本对应关系请参考官方文档。

2. 安装PaddleOCR

完成PaddlePaddle安装后，安装PaddleOCR主包：

pip install paddleocr==3.0.0

命令行快速体验

PaddleOCR提供了便捷的命令行工具，无需编写代码即可快速测试功能。

1. 完整OCR流程（PP-OCRv5）

执行端到端的文本检测与识别：

paddleocr ocr -i ./test_image.png \
    --use_doc_orientation_classify False \
    --use_doc_unwarping False \
    --use_textline_orientation False

2. 单独使用文本检测模块

仅执行文本检测任务：

paddleocr text_detection -i ./test_image.png

3. 单独使用文本识别模块

对已裁剪的文本行图像进行识别：

paddleocr text_recognition -i ./text_line.png

4. 文档结构化分析（PP-StructureV3）

对文档图像进行版面分析和结构化识别：

paddleocr pp_structurev3 -i ./document.png \
    --use_doc_orientation_classify False \
    --use_doc_unwarping False

Python API开发指南

对于需要集成到项目中的开发者，PaddleOCR提供了完善的Python API。

1. 完整OCR流程

from paddleocr import PaddleOCR

# 初始化OCR引擎
ocr = PaddleOCR(
    use_doc_orientation_classify=False,
    use_doc_unwarping=False,
    use_textline_orientation=False
)

# 执行识别
result = ocr.predict("./test_image.png")

# 处理结果
for res in result:
    print(res)  # 打印识别结果
    res.save_to_img("output")  # 保存可视化结果
    res.save_to_json("output")  # 保存JSON格式结果

2. 单独使用文本检测

from paddleocr import TextDetection

detector = TextDetection()
output = detector.predict("test_image.png")

for res in output:
    res.print()  # 打印检测框信息
    res.save_to_img("./output/")  # 保存检测结果可视化

3. 单独使用文本识别

from paddleocr import TextRecognition

recognizer = TextRecognition()
output = recognizer.predict("text_line.png")

for res in output:
    print(f"识别文本: {res.rec_text}, 置信度: {res.rec_score}")

4. 文档结构化处理

from paddleocr import PPStructureV3

pipeline = PPStructureV3(
    use_doc_orientation_classify=False,
    use_doc_unwarping=False
)

output = pipeline.predict("./document.png")

for res in output:
    res.save_to_json("output")  # 保存结构化数据
    res.save_to_markdown("output")  # 保存Markdown格式