Python 3.12下 rapidocr_api 安装失败详解：两步搞定 RapidOCR 安装兼容性

Python 3.12下 rapidocr_api 安装失败详解：两步搞定 RapidOCR 安装兼容性

【免费下载链接】RapidOCR📄 Awesome OCR multiple programing languages toolkits based on ONNX Runtime, OpenVINO, MNN, PaddlePaddle, TensorRT and PyTorch.项目地址: https://gitcode.com/GitHub_Trending/ra/RapidOCR

在 Python 3.12 环境里装 RapidOCR 这个 OCR 工具的 API 组件 rapidocr_api 时，会遭遇安装失败。这篇文章先把修法交给你，再解释原因，看完就能把安装失败修好。

Python 3.12 下 rapidocr_api 安装失败长什么样

在 Python 3.12.4 环境执行安装 rapidocr_api 0.0.7 的命令，pip 走到依赖解析阶段就开始报错，版本要求不满足，整个安装中途被掐断。先说两个排除项：不是网络问题，也不是 RapidOCR 代码本身有问题。卡点在一条第三方依赖上，一个叫 Shapely 的库在新版 Python 里跑不起来，把后面的安装全堵死了。

怎么修：Python 3.12 下修复 rapidocr_api 安装失败的两步顺序

修法其实就一句话：把一次安装拆成两步。

1. 先装核心推理引擎 rapidocr_onnxruntime，版本要求 1.3.24 或更高。
2. 装好引擎之后，再回头装 rapidocr_api。

这两步走完，Shapely 那批依赖会按兼容 Python 3.12 的版本重新解析，之前的安装失败自然消失。装好之后把下面这类图丢给 RapidOCR，日语等多语言文字都能认出来。

为什么 Shapely 兼容性会导致安装失败

大白话讲：rapidocr_api 的依赖链上挂着一个旧版本的几何库 Shapely，而它还没适配 Python 3.12。

打个比方。房子换了新锁（Python 3.12），你手里拿的却还是旧锁配的钥匙（旧版 Shapely）。钥匙没坏，但就是拧不开新锁。先把新版 rapidocr_onnxruntime 装上，相当于换一把能开新锁的钥匙，后面再装 rapidocr_api，门就自然推开了。

在新环境装 RapidOCR 这类项目时的几条建议

• 别急着钉死老版本号，优先装最新稳定版。
• 多组件项目先理清依赖顺序：底层引擎在前，上层组件在后。
• 安装前翻一眼更新日志，确认新版 Python 有没有兼容性说明。
• 用虚拟环境隔离各项目，避免一处依赖冲突牵连别的工程。

想进一步看各组件的细节用法，可以参考 Python 组件文档。

记住这个组合：先 rapidocr_onnxruntime 1.3.24 及以上，再 rapidocr_api。顺序对，安装失败就不会再来。

【免费下载链接】RapidOCR📄 Awesome OCR multiple programing languages toolkits based on ONNX Runtime, OpenVINO, MNN, PaddlePaddle, TensorRT and PyTorch.项目地址: https://gitcode.com/GitHub_Trending/ra/RapidOCR