终端安装Python版Opencv报错numpy构建wheel失败如何解决？

报错内容：

ERROR: Failed building wheel for numpy Failed to build numpy ERROR: Could not build wheels for numpy which use PEP 517 and cannot be installed directly

报错根因 #

该错误触发的核心原因是opencv-python/opencv-contrib-python依赖的numpy版本没有匹配你当前环境（Python版本、CPU架构、系统版本）的预编译wheel包，pip自动尝试从源码编译numpy时缺少必要的编译工具链，同时当前pip版本不支持直接安装不符合PEP 517规范的源码包。

修复步骤 #

• 第一步：先升级基础安装工具到最新版本

pip install --upgrade pip setuptools wheel

• 第二步：提前单独安装适配环境的numpy，避免opencv安装时自动拉取的版本无法编译

pip install numpy

• 第三步：重新执行opencv安装命令

# 安装基础版OpenCV
pip install opencv-python
# 如需带扩展功能的版本，执行下方命令
pip install opencv-contrib-python

• 若上述操作仍失败，可指定安装经过验证、有全平台预编译包的稳定旧版本

pip install opencv-python==4.5.5.62

系统级依赖补充（仅源码编译失败时需要） #

• Debian/Ubuntu 系统先执行：

sudo apt install build-essential python3-dev

• CentOS/RHEL 系统先执行：

sudo yum groupinstall "Development Tools"
sudo yum install python3-devel

• Windows/macOS 系统建议优先安装官方发行的稳定版Python，不要使用预览版或修改版Python环境。

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