You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

macOS High Sierra下Python3.11.4安装Mediapipe失败求助

问题原因与解决方案

问题原因

出现该错误的核心原因是当前安装的Python 3.11.4与mediapipe的预编译包版本不兼容,或pip源无法获取到适配该Python版本的mediapipe包:

  1. Mediapipe对新版本Python的适配存在滞后性,当Python 3.11刚发布时,官方大概率还未推出对应版本的预编译安装包;
  2. 若使用的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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.15 00:37:14