第2章开发环境搭建

Python 版本选择 · OpenCV · NumPy · 摄像头测试

1. Python 版本选择

推荐使用 Python 3.10 ~ 3.12（64位）。OpenCV 和 NumPy 对 3.12 支持良好，且拥有更好的性能与类型提示。避免使用 Python 2.7 或 3.8 以下版本。

                ✅ 建议：通过 python --version 检查当前版本。若版本过低，请从 Python 官方下载页 下载最新稳定版。
            

2. OpenCV 库安装

使用 pip 安装 opencv-python（包含核心库与 contrib 模块）。

pip install opencv-python==4.9.0.80
# 如需额外模块（如 SIFT）可安装 opencv-contrib-python

验证安装：

import cv2
print(cv2.__version__)   # 应输出 4.9.0 或更高

3. NumPy 库安装

NumPy 是 OpenCV 的底层数组依赖，务必安装。

pip install numpy==1.26.4

快速验证：

import numpy as np
arr = np.zeros((4,4), dtype=np.uint8)
print(arr.shape)   # (4,4)

4. 测试摄像头是否可用

编写一段简短的 Python 脚本，打开默认摄像头并显示实时画面。按 q 键退出。

import cv2

cap = cv2.VideoCapture(0)          # 0 代表默认摄像头
if not cap.isOpened():
    print("❌ 无法打开摄像头")
    exit()

while True:
    ret, frame = cap.read()
    if not ret:
        break
    cv2.imshow('Camera Test', frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

如果窗口显示正常，说明环境搭建成功。若报错，请检查摄像头驱动或更换索引 cap = cv2.VideoCapture(1)。

常见问题排查

问题	可能原因	解决方案
ModuleNotFoundError: No module named 'cv2'	OpenCV 未安装	执行 `pip install opencv-python`
摄像头黑屏或报错	索引错误 / 权限不足	尝试 `cap = cv2.VideoCapture(1)` 或关闭占用摄像头的软件
NumPy 版本冲突	环境混乱	使用虚拟环境 `python -m venv .venv`

第2章 开发环境搭建