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/RapidOCRRapidOCR 的 API 组件rapidocr_api 0.0.7在 Python 3.12.4 环境下安装失败根源是依赖库 Shapely 的版本冲突。先装 rapidocr_onnxruntime1.3.24 及以上再装 rapidocr_api即可正常完成安装。故障长什么样执行pip install rapidocr_api0.0.7时安装过程不会在 RapidOCR 本身上报错而是卡在依赖解析环节。典型表现有两类一是提示某个依赖找不到兼容的候选版本整条安装链直接中止二是安装看似完成但 import 时因 Shapely 不兼容而抛错。如果你的环境是 Python 3.12、又准备装 API 组件多半就是遇到了这个依赖版本冲突。为什么偏偏在 Python 3.12 上翻车依赖版本冲突说白了就是齿轮咬合出了问题。每个包都要求自己的依赖落在某个版本区间里就像一组齿轮必须齿数相配才能一起转。当 RapidOCR 的 API 层拉进一个较旧的 Shapely而你的 Python 3.12 又需要更新的 Shapely 才能跑起来两个要求就对不上——齿轮卡住安装就失败。RapidOCR 的 api/ 组件本身没有错卡住的是它依赖链里的那个旧 Shapely这也是为什么单独重试装 API 总是原地打转。两步修复法正确安装顺序关键在于装包顺序底层核心依赖先就位上层组件后安装。第一步先装核心推理库把兼容 Python 3.12 的依赖含 Shapely一次拉到位pip install rapidocr_onnxruntime1.3.24第二步再装 API 组件此时它复用的就是刚才装好的兼容依赖pip install rapidocr_api顺序不能颠倒。先装 API 会让旧的 Shapely 先入坑再补装核心库时就未必能覆盖回去核心依赖先行才能把整条链的齿轮一次性对准。装完怎么验证验证分两步都是轻量操作。先用pip show rapidocr_api rapidocr_onnxruntime确认两个包都已装上且 onnxruntime 版本不低于 1.3.24。再在 Python 里导入并跑一句识别不抛错、能返回结果即代表安装成功。若仍报 Shapely 相关残留错误多半是旧版本还挂在环境里用pip install -U shapely把它的版本顶上去再重试导入即可。相关用法可参考 docs/ 目录下的说明。避坑清单给 Python 3.12 及以上环境的用户几点预防建议优先安装最新稳定版避免长期停留在过旧的 API 版本上。装前看一眼项目更新日志确认当前版本对新 Python 的兼容性。核心依赖先行再装上层组件保持齿轮先对准、再挂上去的顺序。用虚拟环境隔离项目避免多套版本互相污染。结尾遇到 Python 3.12 上 RapidOCR 装不上别再反复重装 API 层。记住顺序先 rapidocr_onnxruntime后 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考