VSCode 与 PyCharm 配置 OpenCV 实战指南(Python/C++)
适用对象:初学者,希望在 VSCode 与 PyCharm 两款常用 IDE 中,学会配置并使用 OpenCV,分别实现 Python 与 C++ 环境的快速上手。 适用平台:Windows 10/11(本文以 Windows 为主要示范,Linux 或 macOS 用户可参照各自系统的包管理细节进行适当调整)。
环境准备
搭建开发环境是第一步。你需要确保系统有足够的磁盘空间(建议至少 10 GB)和内存(8 GB 以上),并能正常访问外网下载依赖。
| 工具/软件 | 作用 |
|---|---|
| Python | 提供 Python 运行时 |
| Visual Studio Build Tools | 提供 Windows 下 C++ 编译器(MSVC)、CMake 等构建工具 |
| VSCode | 轻量级跨平台 IDE |
| PyCharm | JetBrains 出品的 Python IDE |
| OpenCV 预编译包 | 提供 C++ 版库文件 |
安装顺序建议:先装 Python(勾选 Add Python to PATH),再装 VS Build Tools(勾选 C++ build tools 与 SDK),接着是 IDE,最后解压 OpenCV 包。
Python + VSCode 环境配置
本节带你从零开始,在 Windows 平台上搭建基于 VSCode 的 Python + OpenCV 开发环境。
安装 Python
访问 Python 官网下载最新 3.x 版本(如 3.11.x)的 Windows Installer。运行安装程序时,务必勾选底部的 Add Python 3.x to PATH。安装完成后,打开终端输入 python --version 验证。
创建并激活虚拟环境
建议使用虚拟环境隔离项目依赖。
python -m venv venv
进入项目目录后激活:
- PowerShell:
venv\Scripts\Activate.ps1 - CMD:
venv\Scripts\activate.bat
激活后提示符前会出现 (venv) 标记。
安装 VSCode 及插件
下载安装 VSCode 后,在扩展市场搜索并安装官方 Python 插件(ms-python.python)。打开项目文件夹后,点击右下角 Python 版本号,选择指向 venv 的解释器路径。
安装 OpenCV(Python 版)
在激活的虚拟环境中执行:
pip install opencv-python opencv-contrib-python
验证安装:
import cv2
print(cv2.__version__)
编写并运行示例
在项目根目录下新建 opencv_test.py,写入以下代码:
import cv2
():
img = cv2.imread()
img :
()
gray = cv2.cvtColor(img, cv2.COLOR_BGR2GRAY)
cv2.imshow(, img)
cv2.imshow(, gray)
()
cv2.waitKey()
cv2.destroyAllWindows()
__name__ == :
main()


