RapidOCR 在 Python 3.12 装不上？2 步绕开依赖冲突
【免费下载链接】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 安装直接失败，报错滚了一屏却找不到头绪？先别怀疑网络与磁盘，卡点藏在一条不起眼的依赖链里。搞懂这一环，两行命令就能把坑填平。🧱
两行命令，先救急
急着用的话，答案其实只有2 行 pip 命令：先装rapidocr_onnxruntime>=1.3.24，再装rapidocr_api，顺序不能换。具体怎么敲、为什么是这个顺序，往下看。💡
为什么会卡住：Shapely 成了"断链环"
元凶是Shapely这个几何计算库。rapidocr_api 0.0.7间接锁定的旧版 Shapely 没有适配 Python 3.12，pip 解析依赖时走到它这儿就报错终止，整个安装随之失败。⛓️
打个比方：依赖关系像一串链条，Python 3.12 是刚出厂的新链环，旧版 Shapely 是磨损的旧环，接口对不上，整条链咔哒断开，上层组件全都落不了地。这就是常说的"依赖地狱"——不是你操作有问题，而是中间某个旧零件没跟上换代。
Python 3.12 安装 RapidOCR 的正确顺序
第 1 步：先装底层推理后端
pip install "rapidocr_onnxruntime>=1.3.24"第 2 步：再装上层 API 封装
pip install rapidocr_api为什么"先底层、后上层"？从 1.3.24 起的新版后端，安装时会把能在 3.12 上跑的 Shapely 等依赖一并拉进来；地基铺好之后，上层封装再装就不会撞上旧环。顺序反了，就是开头那屏报错。🔧
顺手避坑：4 条老经验
- 装包先查最新版本号：别照抄旧博客里的数字，新稳定版通常已顺手修好这类冲突
- 升级前瞄一眼发布说明：新 Python 版本刚上线时，重点看依赖库的适配进度
- 先底层后上层：后端包装好再装封装层，顺序比命令本身更关键
- 每个项目单开 venv：新旧环境物理隔离，依赖互不踩踏 🛡️
懒得折腾本地环境的话，docker/ 目录备好了多种推理引擎的镜像构建配置，拉起来就能直接试。
FAQ：装完还有疑问？❓
Q：Python 3.10 也要这么装吗？不用纠结。这次冲突集中在新版 3.12 环境，3.10 直接装一般能过；照上面顺序装则百无一失。
Q：怎么确认装成功了？在解释器里敲import rapidocr_onnxruntime, rapidocr_api，不报错就算接通，再跑张图更踏实。
Q：报错里没提 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），仅供参考
