Mac平台Python3.12安装opencv_contrib_python报错求助

错误核心原因 #

• Python3.12移除了pkgutil.ImpImporter接口，旧版本的setuptools/pkg_resources仍在调用该接口，导致构建依赖时出错
• 你尝试安装的opencv-contrib-python-4.8.1.78未适配Python3.12，触发了从源码编译流程，而依赖的numpy==1.22.2也不支持Python3.12

可行解决方案 #

方案1：降级Python到3.11版本 #

Python3.12属于较新的大版本，很多第三方库适配进度滞后，降级到3.11可以避免大部分兼容性问题：

• 从Python官网下载安装Python3.11
• 在VS Code中切换Python解释器到3.11版本
• 重新执行安装命令：

  pip install opencv-contrib-python
  

方案2：安装适配Python3.12的opencv_contrib_python版本 #

目前opencv-contrib-python已更新到支持Python3.12的版本，直接安装最新版：

pip install opencv-contrib-python --upgrade

或者指定明确的兼容版本（比如4.9.0.80及以上）：

pip install opencv-contrib-python==4.9.0.80

方案3：使用conda安装（推荐，避免编译问题） #

如果你已经安装了conda环境，用conda安装可以跳过源码编译，直接获取预编译包：

conda install -c conda-forge opencv-contrib-python

方案4：修复setuptools兼容性问题（临时 workaround） #

如果坚持使用Python3.12，可以手动安装适配3.12的setuptools版本，再尝试安装：

pip install setuptools>=65.5.0
pip install opencv-contrib-python

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