RapidOCR 在 Python 3.12 安装失败？两步装对依赖，报错快速解决

RapidOCR 在 Python 3.12 安装失败两步装对依赖报错快速解决【免费下载链接】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 环境执行pip install rapidocr_api安装中途失败抛出一堆 Shapely 报错。原因是旧版 Shapely 依赖不支持 Python 3.12先把核心包rapidocr_onnxruntime升到 1.3.24 以上再装 API 包即可。先这样做先装 rapidocr_onnxruntime 1.3.24再装 rapidocr_api 0.0.7升级核心推理包到最新版含 1.3.24 及以上pip install -U rapidocr_onnxruntime再装 API 包pip install rapidocr_api✅ 验证安装成功没有任何输出就对了python -c import rapidocr_onnxruntime, rapidocr_apiRapidOCR 的rapidocr_api0.0.7 安装报错解决方法就是这两步别想着一步装完先把底座装好。之前装到一半失败的残留不用手动清理升级命令会直接覆盖。装好后它能识别下面这种图片里的文字⚠️ 两步都做完仍报错先用pip list查一下是不是其他包把旧版 Shapely 拉了回来那才是真凶。为什么会这样Python 3.12 下旧版 Shapely 装不上依赖链像搭积木一块不合适整层塌安装rapidocr_api时pip 不是只装一个包它会沿着依赖声明一层层往下拉库像搭积木一样逐块往上垒。Shapely是链条里负责几何计算的库用来算文字框的形状旧版本没有适配 Python 3.12 的 wheel预编译的安装包pip 装上就能用、不用现场编译积木放上去当场塌上层全跟着失败。这就是报错信息总指向一个你压根没装过的库的原因。修复点在 RapidOCR 1.3.24 这个版本里rapidocr_onnxruntime从 1.3.24 起更新了依赖声明把 Shapely 钉死在支持 Python 3.12 的新版本上。所以先装新的核心包积木从底到顶对齐后面的rapidocr_api自然就装过去了。下次怎么不踩坑装依赖前先对齐三件事优先最新版装 RapidOCR 的组件时带-U拿最新旧版本在新 Python 环境下卡壳的概率大得多。升级前看更新日志发布说明里确认支持你当前的 Python 版本能省掉二十分钟的安装失败。核心包先行依赖链长的项目先装推理引擎包、再装 API 包问题暴露在下层好定位也好修。虚拟环境隔离python -m venv .venv每个项目开一个独立环境装崩了也不会拖垮系统 Python。装对顺序后RapidOCR 在 Python 3.12 上就能正常干活丢一张图片进去文本就出来了。API 组件的更多用法见 api/README.md项目整体介绍在 python/README.md。【免费下载链接】RapidOCR Awesome OCR multiple programing languages toolkits based on ONNX Runtime, OpenVINO, MNN, PaddlePaddle, TensorRT and PyTorch.项目地址: https://gitcode.com/GitHub_Trending/ra/RapidOCR创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考