RapidOCR Python 3.12 安装失败？3 步搞定 rapidocr_api 报错

RapidOCR Python 3.12 安装失败3 步搞定 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/RapidOCRRapidOCR Python 3.12 安装时执行pip install rapidocr_api会卡在依赖解析阶段报错日志基本都指向 Shapely一个做几何坐标计算的库。这是很典型的 rapidocr_api 安装报错根源不在你的环境而是 Shapely 停在旧版本跑不了 3.12。按下面 3 步走很快搞定。3 步修复 rapidocr_api 安装报错先给答案装 rapidocr_onnxruntime底层模型运行库版本锁定 1.3.24 及以上再装 rapidocr_api导入验证一下就这三步顺序别反。为什么是这个顺序往下看。Shapely 不兼容 Python 3.12 是怎么回事一个包的依赖是串成一条链的rapidocr_api 依赖 onnxruntime真正执行模型推理的运行环境onnxruntime 又依赖 Shapely 这类几何库。这条链就叫依赖链。你可以把它想象成接力赛接力棒要一节一节往下传。旧版 rapidocr_api 锁定了老 Shapely。老 Shapely 只认低版本 Python在 3.12 上装不上。整条链断在一环pip 只能报错退出。修法其实很简单。新版 rapidocr_onnxruntime1.3.24 起换上了适配 3.12 的依赖版本。所以先把它装上pip 就会挑一个能用的新版 Shapely。之后再装 rapidocr_api链条自然顺了。RapidOCR Python 3.12 安装手把手命令与预期结果⚠️ 建议开个虚拟环境再操作别把系统 Python 弄乱。第 1 步先装底层运行库pip install rapidocr_onnxruntime1.3.24这一步把模型运行库升到兼容 3.12 的版本顺带把新版 Shapely 拉下来。第 2 步再装 rapidocr_apipip install rapidocr_api依赖链已经打通这步应该直接装完不再报版本冲突。第 3 步导入验证python -c import rapidocr_api; print(OK)✅ 终端打出OK就说明装好了。仓库里自带测试图比如 python/tests/test_files/随便拿一张跑次识别能吐出文字就齐活了。Python 3.12 依赖问题通用排查方法这次踩的坑不是孤例。下次再遇到类似的依赖报错按这个流程走看日志最后几行pip 报错末尾一般有 ERROR: Could not find a version 字样。后面跟着的库名就是元凶这次是 Shapely。定位问题全靠它先装核心依赖上层包卡住时手动把底层库升到位再装上层组件往往直接绕开冲突查更新日志看看项目是否已发新版修掉这个依赖问题。API 组件的安装说明见 api/README.md项目文档在 docs/虚拟环境隔离新环境里复现问题不污染其他项目出问题直接重建RapidOCR 团队已经在新版本里修掉了 Shapely 版本不兼容的问题。以后遇到安装失败直接装最新版就行。【免费下载链接】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），仅供参考