Mac系统Python3.10安装opencv-python报numpy构建失败如何解决

不用上来就卸载现有numpy，这个报错绝大多数情况和你已经装了numpy没关系，都是环境路径错配、pip版本过老、缺少编译依赖或者版本不匹配导致的，盲目卸载反而容易把其他依赖numpy的项目环境搞坏。

• 先核对pip和Python环境是不是对应上了
  Mac上多版本Python共存是常态，系统自带的、brew装的、pyenv装的、conda装的经常混在一起，很多时候你敲的pip3.10根本不属于你装了numpy的那个Python3.10环境，pip找不到对应环境里已安装的numpy，就会自己拉源码编译，缺编译依赖直接就报你贴的这个错。先跑两个命令核对路径：

  which python3.10
  which pip3.10
  

  正常两个返回的路径应该在同一个目录层级下，要是路径对不上，以后别直接用pip3.10这种裸命令，用对应Python解释器直接调用pip最稳妥，能100%避免串环境的问题：

  python3.10 -m pip install opencv-python
  

• 装基础编译依赖，升级pip工具链
  如果路径核对没问题，先装Mac上编译Python包必需的Xcode命令行工具：

  xcode-select --install
  

  等安装完成后，把pip、setuptools、wheel这几个基础打包工具升到最新版，老版本pip的依赖解析逻辑有很多bug，明明有现成的预编译wheel包，非要拉源码下来编译，平白无故出问题：

  python3.10 -m pip install --upgrade pip setuptools wheel
  

  升级完先重试装opencv-python，一半以上的情况这步就能直接装成功。
• 固定兼容版本的numpy
  如果重试还是报numpy编译失败，先查下当前Python3.10环境里装的numpy版本：

  python3.10 -c "import numpy; print(numpy.__version__)"
  

  对Python3.10和opencv-python兼容性最好的numpy稳定预编译版本是1.26.4，如果你当前装的版本低于1.21.2，或者是2.0以上的测试预览版，pip会为了满足opencv的依赖要求尝试重装numpy，这时候直接装预编译好的兼容版本就行，不用提前卸载：

  python3.10 -m pip install numpy==1.26.4
  

  装完再执行opencv-python的安装命令就不会触发numpy编译流程了。

只有两种情况需要卸载：

• 你确认当前Python3.10环境里的numpy是之前源码编译失败残留的坏包，导入都报错
• 现有numpy是通过brew、conda等其他渠道安装的，根本不在当前pip管理的包路径下
  卸载的时候也别直接敲裸pip命令，用对应解释器调用pip卸载，避免删错其他环境的包：

python3.10 -m pip uninstall numpy

额外提醒：如果你用的是M系列（Apple Silicon）芯片的Mac，别装4.5.5以前版本的opencv-python，这些老版本没有arm64架构的预编译包，会强制触发全量依赖编译，肯定会报错。

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