macOS High Sierra下Python3.11.4安装Mediapipe失败求助
问题原因与解决方案
问题原因
出现该错误的核心原因是当前安装的Python 3.11.4与mediapipe的预编译包版本不兼容,或pip源无法获取到适配该Python版本的mediapipe包:
- Mediapipe对新版本Python的适配存在滞后性,当Python 3.11刚发布时,官方大概率还未推出对应版本的预编译安装包;
- 若使用的pip源同步不及时,也会导致无法检索到适配的mediapipe版本。
解决办法
1. 降级Python到兼容版本(最稳妥方案)
查看mediapipe支持的Python版本(通常适配到当前主流稳定版,比如Python 3.10.x系列),卸载Python 3.11.4后安装Python 3.10.x版本,重新执行安装命令:
python -m pip install mediapipe
2. 尝试更换国内pip镜像源
如果是源同步延迟问题,可切换到国内镜像源加速包检索,执行命令:
python -m pip install mediapipe -i https://pypi.tuna.tsinghua.edu.cn/simple
3. 从源码编译安装(适合有开发环境的用户)
若必须使用Python 3.11,可手动编译mediapipe源码:
- 先安装编译依赖:CMake、对应平台的编译工具(Windows需安装Visual Studio,Linux需安装gcc/g++)、OpenCV、FFmpeg等;
- 克隆mediapipe仓库:
git clone https://github.com/google/mediapipe.git - 按照mediapipe官方编译文档配置环境,生成Python wheel包后,执行本地安装:
pip install path/to/generated/wheel/file.whl
4. 确认pip与Python版本匹配
执行以下命令确认pip是否绑定当前Python 3.11:
python --version pip --version
若pip对应的是其他Python版本,需重新安装对应版本的pip,或使用python3.11 -m pip install mediapipe明确指定Python版本执行安装。
内容的提问来源于stack exchange,提问作者Konstantin Khatskevich
相关产品推荐
相关产品推荐

