📷 第2章 OpenCV环境搭建

2.1 OpenCV 库介绍

OpenCV (Open Source Computer Vision Library) 是一个跨平台的计算机视觉库，提供超过2500种优化算法，涵盖图像处理、视频分析、机器学习等模块。自2000年发布以来，已成为学术界和工业界事实上的视觉标准。

在摄像头调用场景中，我们主要使用 cv2.VideoCapture (videoio) 读取帧，cv2.imshow (highgui) 显示画面，以及 cv2.cvtColor (imgproc) 做色彩空间转换。

2.2 pip 安装 OpenCV

推荐使用 Python 3.8+ 环境，通过 pip 安装官方预编译包：

# 安装标准版（推荐）
pip install opencv-python

# 如果需要额外 contrib 模块（特征匹配、跟踪等）
pip install opencv-contrib-python

国内用户可添加镜像源加速：pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple

2.3 验证安装

打开 Python 交互环境或新建脚本，执行以下代码确认安装成功：

import cv2
print(cv2.__version__)   # 例如 4.9.0
print(cv2.getBuildInformation())  # 查看编译信息

若输出版本号且无报错，则环境搭建成功。下表列出常见版本与Python兼容性：

2.4 常见安装问题解决

• ❌ 报错 “No module named cv2” — 未正确安装或使用了虚拟环境。执行 pip list | findstr opencv (Windows) 或 pip list | grep opencv (macOS/Linux) 检查。
• ❌ 安装时卡住或超时 — 使用国内镜像：pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
• ❌ 动态库加载失败 (DLL load failed) — 缺少VC++运行库。安装 Microsoft Visual C++ Redistributable 或更新系统。
• ❌ macOS 上摄像头无法打开 — 授予终端/IDE 摄像头权限，或使用 cv2.CAP_AVFOUNDATION 后端。