Python 3.12 装不上 RapidOCR两步搞定 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如果你用 Python 3.12 装 RapidOCR 失败了先别怀疑环境——多半是安装顺序没对。记住这个结论先装 rapidocr_onnxruntime 1.3.24 及以上版本再装 rapidocr_api两条命令就能解决 rapidocr_api 安装失败的问题。分步修复按正确顺序装第 1 步先装底层核心库pip install rapidocr_onnxruntime默认装到的就是最新版。想稳妥一点可以显式指定最低版本pip install rapidocr_onnxruntime1.3.24第 2 步再装 API 组件pip install rapidocr_api⚠️ 顺序不能反过来。第 1 步装好后第 2 步会顺理成章地成功。为什么会失败一个 Shapely 兼容性问题问题出在依赖链上。在 Python 3.12.4 环境里装 rapidocr_api 0.0.7 时pip 会按声明去拉取对应版本的 Shapely而那个旧版 Shapely 与 Python 3.12 并不兼容安装过程直接报错中断。打个比方核心包已经升级了链上的依赖包却没跟上。先装上较新版本的 rapidocr_onnxruntime 后依赖关系会落到一组能兼容 3.12 的版本上之后再装 rapidocr_api 就不会被那个旧 Shapely 卡住。这也是这类问题的典型特征——报错往往发生在上层组件根因却在它依赖的底层库。避坑清单如何少走同类依赖弯路装之前先看一眼项目的最新稳定版和更新日志确认它适配你当前的 Python 版本强依赖的分层组件先装核心依赖、再装上层组件顺序别乱新版 Python 上装失败时重点排查报错里提到的第三方库版本而不是反复重试不同项目用虚拟环境隔离避免已装好的旧版本互相干扰常见问题问能只重装 rapidocr_api 吗不行。卡在依赖链里的 Shapely 版本不会因为重装上层组件而改变必须先装新版 rapidocr_onnxruntime再装 rapidocr_api。问装到最新版仍然报错怎么办先升级 pip 本身清一下安装缓存再重新走上面的两步pip install --upgrade pip pip cache purge如果还失败用干净的虚拟环境从头来一遍基本都能过。✅ 装完后可以拿一张文字样图跑一下识别确认环境没问题更多用法细节可参考 api/README.md 和官方文档。RapidOCR 官方团队一直在跟进 Python 生态的版本变化这类兼容性问题也会持续修复。建议养成习惯新环境下装组件先看更新日志按依赖顺序来坑自然就少了。【免费下载链接】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），仅供参考