1. 创建新项目

在这个 Visual Studio 的 Python 项目(Python 3.11)中配置 OpenCV,步骤很简单:
配置步骤
- 打开终端:在 Visual Studio 中,点击「视图」→「终端」,打开项目终端。

- 安装 OpenCV 库:在终端中输入命令(使用 pip 安装 Python 版 OpenCV):
pip install opencv-python
下载时间较长,请耐心等待。推荐使用国内镜像加速:
pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
常见问题与解决方案
问题 1:C 盘权限导致下载失败 如果文件所在目录是 C 盘可能会下载失败,需重新以管理员方式打开软件即可重新下载成功。
问题 2:Python 版本与 OpenCV 包不兼容 原因可能是安装的 opencv-python 版本针对旧版 Python(如 cp37),而项目使用的是其他版本(如 Python 3.11),或者下载速度过慢导致中断。
解决方法:
- 安装对应版本的 OpenCV:在终端输入(指定适配 Python 3.11 的版本):
pip install opencv-python==4.8.0.76 -i https://pypi.tuna.tsinghua.edu.cn/simple
- 验证安装:安装完成后,在 Python 文件中运行以下代码:
import cv2
print(cv2.__version__)
输出 4.8.0.76 则表示成功。
问题 3:NumPy 包下载超时 核心原因是网络问题。可尝试离线安装 NumPy 方案。
步骤 1:手动下载适配的 NumPy 包
访问清华镜像站 NumPy 页面,下载适配 Python 3.11(cp311)+ Windows 64 位(win_amd64)的 1.26.4 版本包,文件名类似:numpy-1.26.4-cp311-cp311-win_amd64.whl。
步骤 2:离线安装下载好的包
回到终端,使用 pip install 加上本地包路径安装(替换为实际下载路径):
pip install "C:\Users\xxxx\Downloads\numpy-1.26.4-cp311-cp311-win_amd64.whl" --force-reinstall
步骤 3:验证并运行代码 安装完成后,重新运行你的代码。
2. 测试代码(验证配置)
在 中写入以下代码(读取并显示图片):

