ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

RapidOCR在Python 3.12装不上?三步直接跑通

2026/9/20 7:39:07 拓冰建站 浏览量
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/RapidOCRRapidOCR 是一个支持 ONNX Runtime、Paddle 等多种后端的 OCR 识别工具包。本文只解决一个具体的安装失败rapidocr_api 在 Python 3.12 下装报错。卡点在一个依赖库上把安装顺序摆对就能过。你大概率也撞过这个墙不是你电脑的问题是这个包在 3.12 上装不进去。 一个全新的虚拟环境、一条干干净净的命令转了两圈就停屏幕底下刷出一行红字ERROR: Cannot install rapidocr_api上面还跟着一长串 shapely 编译失败的日志。 你甚至可能换了国内镜像、升级了 pip 再试还是那行红。这个失败是确定性的跟你的机器性能、网络快慢都没关系。到底卡在哪了本质不是 OCR 识别出了问题是接力棒传错了。rapidocr_api的依赖链里有个shapely它负责文本框顶点、框与框相交这类几何计算这个库的旧版本在 Python 3.12 上要么编译不过、要么导入即崩。就像一支接力队有一位老版本队员没过新规则检查整条链都起不了跑。团队后来是靠收紧这个依赖的版本约束修好的这正是下面那套顺序装法子成立的前提。按这个顺序装一次通过⚡️ 别一上来就硬装 rapidocr_api看着快其实是死路。按下面的顺序来就行。装核心包rapidocr_onnxruntime版本钉在1.3.24以上。它是真正加载模型、执行识别的包且带着完整的依赖清单含修好版本约束的 shapely先装它能让整棵依赖树按 Python 3.12 的规则铺开。 核心包落定之后后面就是顺水推舟。装接口包rapidocr_api。轮到 pip 解析它时环境里已经是兼容的 shapely 了不会再回头去编译一个旧版本然后崩给你看。 两个包都落袋就可以验货了。丢一张测试图跑一次 OCR 识别。文字出来了、框也框对了整条链路就算真正通了。装了之后顺手做这几件事环境一定单独建我当年省这一步后面混包混到分不清谁是谁。给 RapidOCR 单开一个 3.12 的 venv系统环境干净着。升级包之前瞄一眼发布说明。这个项目迭代很快版本说明里把兼容性写得很明白。再遇到报错先把那行 ERROR 原样抄下来。拿这一行去提 issue比贴整段日志快得多。想跑生产环境的看看 docker/ 目录每种推理后端都有现成的镜像能省掉一堆手工折腾。想再深入一点翻翻 python/README.md用法示例、参数和多语言识别的配置都在里面。一句话收尾这件事从出坑到修好团队只隔了一个版本修法直白到只是在依赖清单上加了一行版本约束。能看到依赖环节上药过程的项目你才敢放心把活儿交给它。以后再有坑先去翻一眼发布说明十有八九答案就摆在那。【免费下载链接】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),仅供参考