Windows环境下cv2安装失败及Mediapipe适配Python3.11问题求助

一、cv2安装问题的补充验证（已修复可跳过） #

如果后续再次出现cv2模块找不到的情况，核心原因大概率是pip与Python版本不匹配：

• 直接使用Python 3.11对应的pip路径执行安装，避免多版本Python干扰：

  E:\python\Scripts\pip.exe install opencv-python
  

• 打开Python终端输入import cv2，无报错则确认安装稳定。

二、Mediapipe安装失败的解决步骤 #

问题根源 #

Python 3.11发布初期，Mediapipe官方未及时提供对应版本的预编译包，导致pip无法检索到匹配发行版；同时你的pip版本过旧，也会影响包的检索能力。

具体解决方法 #

1. 升级pip至最新版本
   执行提示中的升级命令，确保pip版本更新：

   E:\python\Scripts\python.exe -m pip install --upgrade pip
   

   完成后可通过pip --version确认版本已升级至22.3.1及以上。

2. 适配Python 3.11的Mediapipe安装方案

   • 方案一：手动安装预编译whl包
     找到适配Windows系统、Python 3.11的Mediapipe whl包（文件名格式类似mediapipe-0.x.x-cp311-cp311-win_amd64.whl），下载后切换到文件所在目录，执行：

     E:\python\Scripts\pip.exe install [下载的whl文件名].whl
     

   • 方案二：从源码编译安装
     先安装CMake及Visual Studio的C++开发组件，再克隆仓库编译：

     git clone https://github.com/google/mediapipe.git
     cd mediapipe
     python setup.py install
     

     该方案编译耗时较长，适合熟悉编译流程的用户。
   • 方案三：降级Python至3.10版本
     若不想折腾编译或查找whl包，可将Python降级至3.10，Mediapipe官方对该版本有完整预编译支持，直接执行pip install mediapipe即可完成安装。

安装验证 #

打开Python终端，输入import mediapipe as mp，无报错则说明安装成功。

内容的提问来源于stack exchange，提问作者pleasehelphonestly