如何在Visual Studio Code中为Python安装OpenCV及解决numpy构建报错

核心原因 #

报错Could not build wheels for numpy的根因是Python3.10.0正式发布初期，最新版numpy、opencv-python未提供适配该版本的预编译wheel包，pip自动尝试从源码编译numpy时缺少对应的C++编译环境，导致安装失败。

解决步骤 #

• 第一步：卸载当前环境中已安装的numpy，避免版本冲突
  执行命令：pip uninstall numpy -y
• 第二步：安装经过适配的指定版本依赖包，直接拉取预编译安装包跳过源码编译流程
  执行命令：pip install numpy==1.21.6 opencv-python==4.5.5.62 opencv-contrib-python==4.5.5.62
• 第三步：若上述命令仍触发编译报错，添加参数强制拉取预编译包
  执行命令：pip install --only-binary :all: numpy==1.21.6 opencv-python==4.5.5.62 opencv-contrib-python==4.5.5.62
• 第四步：验证安装结果
  打开Python交互终端执行命令：import cv2; print(cv2.__version__)，正常输出版本号即为安装成功。

补充说明 #

你之前下载的OpenCV exe安装包是面向C++开发的程序包，Python调用的opencv-python依赖包不需要依赖该安装包，无需额外安装配置。

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