保存时间:2026/3/29 16:30:34
python --version 或 python3 --version,确认版本符合要求。若未安装,可从 Python官网 下载对应版本。xcode-select --install)。# 升级pip(可选,确保安装工具最新)
python -m pip install --upgrade pip
# 安装CPU版PaddlePaddle
pip install paddlepaddle==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install paddlepaddle-gpu==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install paddleocr==2.7.0.3 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install paddleocr)git clone https://github.com/PaddlePaddle/PaddleOCR.git
cd PaddleOCR
# 安装Python依赖
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
# 安装PaddleOCR(本地源码)
python setup.py install
ImportError: libGL.so.1: cannot open shared object file 等错误:sudo apt-get update
sudo apt-get install -y libgl1-mesa-glx libglib2.0-0
sudo yum install -y mesa-libGL.x86_64 glib2.x86_64
test.jpg,放在当前目录)。 paddleocr --image_dir ./test.jpg --use_angle_cls true --lang ch
--image_dir:指定图片路径 --use_angle_cls true:开启角度检测(解决倾斜文本识别问题) --lang ch:指定识别语言(ch为中文,en为英文,其他语言参考官方文档)Permission denied,在命令前加 sudo(Linux/Mac)或使用虚拟环境(推荐)。 pip uninstall xxx),重新安装指定版本。 --det_model_dir 等参数指定路径。Successfully installed paddlepaddle-3.2.0 safetensors-0.6.2,说明 paddlepaddle==3.2.0 已正确安装到你的环境中,核心依赖可用。clip-interrogator、imagen-pytorch、peft、trl 等需要 transformers)是其他已安装的第三方包的依赖需求,而非 paddlepaddle 或 PaddleOCR 本身的依赖。 clip-interrogator)可能是你之前安装的其他工具(与 OCR 无关),它们需要 transformers 但你当前环境中没有安装,因此 pip 提示冲突。 transformers,因此这些冲突不会影响 PaddleOCR 的正常使用。# 安装 PaddleOCR(推荐指定版本,兼容性更稳)
pip install paddleocr==2.7.0.3 -i https://pypi.tuna.tsinghua.edu.cn/simple
# 安装 Ubuntu 系统依赖(关键,否则可能运行报错)
sudo apt-get update && sudo apt-get install -y libgl1-mesa-glx libglib2.0-0
# 测试识别(准备一张图片,如 test.jpg)
paddleocr --image_dir ./test.jpg --use_angle_cls true --lang ch
clip-interrogator),再解决依赖clip-interrogator 等工具,单独安装 transformers 即可解决冲突: pip install transformers -i https://pypi.tuna.tsinghua.edu.cn/simple
paddlepaddle==3.2.0 是较新版本,而 PaddleOCR 对新版本的适配可能存在延迟(官方文档通常推荐 2.x 稳定版)。 pip uninstall paddlepaddle
pip install paddlepaddle==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
paddleocr 而非 paddlepaddle --image_dir ...,但正确的命令应为 paddleocr(OCR的专用命令)。正确格式: paddleocr --image_dir ./test.png --use_angle_cls true --lang ch
DeprecationWarning: distutils Version classes are deprecated 是非致命警告,源于依赖库的版本兼容提示,不影响PaddleOCR的正常运行,可忽略。libgl1-mesa-glx 和 libglib2.0-0)必须安装,否则可能出现“无法加载共享库”错误: sudo apt-get install -y libgl1-mesa-glx libglib2.0-0
pip list | grep paddleocr
pip install paddleocr==2.7.0.3 -i https://pypi.tuna.tsinghua.edu.cn/simple
test.png 中的文字,输出结果会包含检测到的文本内容及坐标。