Python 3.12 装 RapidOCR 失败？两步 pip 就能让 OCR 环境一次通过

Python 3.12 装 RapidOCR 失败两步 pip 就能让 OCR 环境一次通过【免费下载链接】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 上跑新的 OCR 项目pip installRapidOCR 的 API 组件直接失败。现象不罕见报错一长串pip 把已下载的包全部回滚最后什么都没装上。根因怎么定位、按什么顺序装才能过一次给你交代清楚。现场还原pip 整包回滚典型场面是这样的你敲下pip install rapidocr_api进度条跑完最后阶段终端弹出类似这样的内容——ERROR: Cannot install rapidocr_api 0.0.7 because these package versions have conflicting dependenciesrapidocr_onnxruntime 1.3.23 depends on Shapely (2.0.4, broken on Python 3.12)Rolling back: rapidocr_api, rapidocr_onnxruntime, Shapely看到这几行的话先别怀疑网络、镜像源或者 pip 版本这是版本冲突不是环境问题。根因定位Shapely 版本在 Python 3.12 上的冲突一层层剥开看表层pip 找不到一套满足所有约束的版本组合于是整包回滚。直接原因旧版 rapidocr_onnxruntime 的依赖声明没有排除 Shapely 2.0.4而 2.0.4 在 Python 3.12 上有已知缺陷装上也跑不起来。底层是依赖链rapidocr_api 依赖 rapidocr_onnxruntime后者再拖进 Shapely。这就是典型的依赖地狱dependency hell包与包之间版本互相锁死。新 Python 版本发布后底层依赖的适配总有一段空窗底层没通上层全部卡死。修复已经落在新版依赖声明里Shapely 约束放宽为Shapely1.7.1,!2.0.4可以在仓库的 python/requirements.txt 里直接核实。修复路径rapidocr_onnxruntime 依赖顺序安装步骤先装底层核心pip install rapidocr_onnxruntime1.3.24。为什么排第一它才是依赖链的核心新版会带上 3.12 下可正常工作的 Shapely。再装上层组件pip install rapidocr_api。此时解析器在环境里找到兼容的 Shapely不再回滚。预期现象安装一气呵成无 rollback。验证python -c import rapidocr_api无报错即通过。再次强调先 rapidocr_onnxruntime、后 rapidocr_api是硬顺序不可调换。反了的话旧版底层先被锁定api 层只能迁就它问题照样出现。装通之后拿一张样例图跑一次识别验证环境。仓库测试目录里就有现成的日语样本延伸一屏依赖地狱依赖地狱是 pip 生态的共性依赖越多越容易被彼此锁死。新版 Python 发布后总会有一段窗口期部分包的 wheel 还没构建好。同类坑还有Requires-Python区间不匹配、二进制 wheel 缺失。原则就一条出错先看底层依赖别急着换镜像。避坑清单✅ 装之前先升到最新稳定版pip install -U rapidocr_onnxruntime✅ 装前查项目更新日志确认新 Python 版本是否已适配✅ 核心依赖先装上层组件后装别一步到位装顶层⚠️ 用虚拟环境隔离python -m venv .venv不同 Python 版本不要混用⚠️ 生产环境选 3.10 / 3.11 更稳尝鲜 3.13 建议走测试环境两条命令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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考