3. OpenCV环境搭建

第3章 · 环境基石

OpenCV环境搭建

安装 OpenCV-Python 库、验证安装、读取与显示第一张图片。

📦 安装 OpenCV-Python 库

使用 Python 包管理器 pip 可以快速安装 OpenCV 及其依赖。推荐在虚拟环境中进行，避免版本冲突。

# 创建虚拟环境（可选）
python -m venv cv_env
source cv_env/bin/activate   # Linux / macOS
cv_env\Scripts\activate      # Windows

# 安装 OpenCV
pip install opencv-python

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

🔍 验证安装

在 Python 交互环境或脚本中导入 cv2 并输出版本号，确认安装无误。

import cv2
print("OpenCV 版本:", cv2.__version__)
# 预期输出类似：OpenCV 版本: 4.9.0

🖼️ 读取与显示第一张图片

使用 cv2.imread() 加载图像，cv2.imshow() 显示窗口，cv2.waitKey() 保持窗口。

import cv2

# 读取图片（请将 'lena.jpg' 替换为你的图片路径）
img = cv2.imread('lena.jpg')

# 检查是否读取成功
if img is None:
    print("图片读取失败，请检查路径")
else:
    # 显示图片
    cv2.imshow('我的第一张OpenCV图片', img)
    # 等待按键，参数0表示无限等待
    cv2.waitKey(0)
    cv2.destroyAllWindows()

📋 环境搭建常见问题

问题	可能原因	解决方式
pip 安装失败	网络超时 / 缺少编译工具	使用国内镜像 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple opencv-python
导入 cv2 报错	Python 环境不对 / 未安装	检查虚拟环境，重新安装
imread 返回 None	路径错误 / 文件损坏	使用路径，检查图片格式
窗口不显示	未调用 waitKey	添加 cv2.waitKey(0)