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 环境里装rapidocr_api经常装到一半就报错退出。这是 RapidOCR 安装时最常被卡住的一类兼容问题和 3.12 本身没毛病。按下面的顺序操作两条命令就能把环境搭好装完后检测、识别功能都能正常跑。谁会遇到这篇症状自查先对号入座满足下面三条基本就是同一个坑解释器是 Python 3.12.x不是 3.10 或 3.11。你执行的是pip install rapidocr_api0.0.7且装到依赖解析阶段就失败。报错信息里出现shapely/Shapely字样或卡在某个 C 扩展编译不上。三条全中往下看即可不用折腾环境。如果你装的是最新版、环境也新多半一次就过这篇帮不上忙。根因 60 秒讲清问题出在依赖链最底层不在 RapidOCR 代码本身。rapidocr_api会拉起文本检测模块检测模块用到了几何库shapely来算多边形框在 Python 3.12 下旧版 shapely 的预编译包和 C 扩展对不上号就装不上。打个比方底层那块积木已经换代上层模块还拿着旧接口的图纸去找自然拼不到一起。这个冲突在项目的 python/requirements.txt 里能直接看到Shapely1.7.1,!2.0.4注释写着python3.12 2.0.4 bug。也就是说 2.0.4 这个版本在 3.12 上有坑官方已经明确把它排除了。shapely 具体在哪儿被用到可以看 python/rapidocr/ch_ppocr_det/utils.py 里的from shapely.geometry import Polygon。修复操作 如何验证装好了 关键只有一句话先装 onnxruntime再装 api顺序不能反。先装 rapidocr_onnxruntime 再装 rapidocr_apionnxruntime 是整条链里最底层、也最容易被卡住的部件先把它的版本提到 1.3.24 及以上pip install rapidocr_onnxruntime1.3.24确认它装好后再装 API 层pip install rapidocr_apiShapely 冲突怎么确认装完做两步验证。第一终端里执行import rapidocr_api不报错就对了再用pip show rapidocr_onnxruntime看一眼版本应在 1.3.24 或更高。第二拿一张文字图跑一遍 OCR能正常返回文本说明检测、识别整条链路都通了。下面这张就是仓库自带的测试样例变体问题如果还报别的错装到第二步又失败多半是 shapely 版本没排干净按这个顺序排查用pip show shapely查当前版本。若是 2.0.4先卸掉再让 pip 重新解析它本来就不该出现在 3.12 里。报缺依赖或解析残留多是 pip 缓存导致加--upgrade或清一下缓存再装一遍。若rapidocr_onnxruntime自己装不上多半是网络或镜像问题换官方或就近源别在版本上继续降。多数情况走完前两条就装好了。真到要动 shapely 版本时记住一条跟着 requirements.txt 的约束走别自己猜版本。延伸顺手可以做的配置 这四个习惯能让类似问题以后不再找上你优先最新稳定版。装依赖时别锁死旧号先试最新稳定版多数兼容问题官方已经处理了。看更新日志。升级前先扫一眼 changelog版本兼容信息一般写在里面。核心依赖先行。像 onnxruntime 这种底层部件先单独装好、确认版本再往上叠。用虚拟环境隔离。每个项目一个 venv3.12 的坑不会串到别的解释器里去。按 onnxruntime 在前、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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考