ImportError 别慌3 步搞定 MediaPipe Python 兼容性报错【免费下载链接】mediapipeCross-platform, customizable ML solutions for live and streaming media.项目地址: https://gitcode.com/GitHub_Trending/med/mediapipepip 装完 mediapipe一 import 就报cannot import name Sequence from collections对就是那个红字。这类 MediaPipe Python 兼容性问题九成出在 Python 版本和依赖树照下文改完就能跑。先对号入座你的报错是哪一类常见的 MediaPipe ImportError 修复路径就三条先确认你中哪一条。导入路径报错collections 里找不到 Sequencecollections.Sequence在 Python 3.10 被正式移走老代码还按旧路径导入就炸。当前仓库的mediapipe/python/packet_creator.py已经改用 typing 导入所以这行报错多半来自你自己的脚本或旧第三方包不用怀疑仓库源码。Python 3.9 及以下不受影响但官方支持线已经拉到 3.9 起步建议顺手升级。依赖版本打架numpy 和预编译二进制不匹配requirements.txt只写包名不写版本pip 默认拉最新numpy 一到 2.xABI 就变了而 mediapipe 和 opencv 的轮子是按 1.26 编译的于是报numpy.dtype size changed, C API may be incorrect。这是 MediaPipe 依赖冲突解决里最高频的一类pip show numpy看一眼版本就能确认。同理protobuf 版本和轮子编译时用的不一致时import 阶段也可能抛错。系统调用受限libGL 或音频设备找不到无显示器的 Linux 上 import 挂在libGL.so.1是系统缺图形库和包本身无关Windows 或 macOS 上sounddevice报 PortAudio 错误则是音频驱动没装好或设备被占用。报错现象触发条件一句话根因cannot import name SequencePython 3.10 跑老导入旧路径 3.10 起被移除numpy.dtype size changed装到了 numpy 2.x二进制按 1.x 编译libGL.so.1: cannot open无头 Linux缺系统图形库别慌下面逐个修。对症修复MediaPipe 兼容性按版本一次对齐每个版本只给最小改动改完跑import mediapipe验证。Python 3.10把 Sequence 的导入换到 collections.abc打开报你名字的那个脚本找到这行from collections import Sequence # 报错的就是它 from collections.abc import Sequence # 改成这行就改一行语义完全一样collections.abc 是官方迁移后的新家两个名字指的是同一个抽象基类。如果是旧版 mediapipe 轮子里带出来的直接pip install -U mediapipe升到新版绕开不用去动 site-packages。Python 3.11 安装 MediaPipe装完先对齐两个依赖3.11 上最容易翻车的还是 numpy。仓库根目录的requirements_lock_3_11.txt已经把版本钉死numpy1.26.4、protobuf4.25.5照着对齐就行pip install mediapipe pip install numpy1.26.4 protobuf4.25.5先装 wheel 再钉版本顺序别反否则 pip 的解析器可能又给你升回去。钉完跑一下python -c import mediapipe as mp; print(mp.__version__)能打印版本号就通了。Python 3.12直接用锁定文件装依赖setup.py里官方标注支持 3.9 到 3.123.12 本身没有兼容坑关键还是别让 pip 装到 numpy 2.x。手里有仓库源码的话一条命令最省事pip install -r requirements_lock_3_12.txt再补一个pip install mediapipe。锁定文件是 pip-compile 自动生成的依赖树和开发环境一致装完基本不用二次排查从源码构建时文件里的 jax、sentencepiece 也会按同一版本装齐省掉反复试错。没克隆仓库的话照 3.11 的钉版本方式做即可。把环境焊死venv 锁定文件换台机器、交给同事环境别从零重来。我每次都是这么搞的python -m venv mp_env --python3.11 # 隔离环境钉住 Python 版本 source mp_env/bin/activate # 激活Windows 用 mp_env\Scripts\activate pip install -r requirements_lock_3_11.txt # 依赖版本一次钉死 pip install mediapipe # 最后装本体四步走完venv 记录解释器和顶层包锁定文件记录每个依赖的精确版本两层一起才叫焊死同事照着这四条命令走装出来的环境和你这台一模一样。依赖要更新时跑一句pip-compile --output-filerequirements_lock_3_11.txt requirements.txt重新生成即可它的作用就是把可解析的依赖树落成精确版本不用手改以后每次升级都重新编译一遍锁定文件团队里就不会各装各的了。换机器之前看一遍⚠️先建 venv 再装包别裸装系统环境锁定文件跟着版本选_3_11 和 _3_12 别混着装numpy 先钉 1.262.x 等官方适配报错读最后一行ImportError 根因在最后无头 Linux 缺libGL是系统问题装图形库就行sounddevice 报错先查设备占用和驱动✅ 顺序别乱导入 → 依赖 → 系统库跑通了就收藏这篇下次换环境回来翻就行。遇到表里没覆盖的报错去项目 issue 里搜一下多半已经有人踩过同一条坑。【免费下载链接】mediapipeCross-platform, customizable ML solutions for live and streaming media.项目地址: https://gitcode.com/GitHub_Trending/med/mediapipe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
