1552 字
8 分钟
记录第一次使用opencv调用摄像头
2026-09-12笔记opencvpython

第一次使用 OpenCV 调用摄像头实操记录#

本文记录本人首次使用 Python + OpenCV 实现电脑本地摄像头调用、实时画面展示、画面捕获、窗口退出的完整实操过程。全文包含环境安装、完整可运行代码、逐行代码详解以及实操踩坑解决方案，逻辑清晰、零基础友好，适合新手入门 OpenCV 视觉开发。

一、环境准备#

本次开发基于 Python 环境，核心依赖 OpenCV 视觉库，全程采用 pip 官方镜像安装，安装速度快、报错率低。

1. 检查 Python 环境#

打开终端/CMD，输入以下命令，校验 Python 是否正常安装：

Terminal window
python --version

若输出版本号（Python 3.7 及以上均可），说明环境正常；若无响应，需先下载安装并配置 Python 环境。

2. 安装 OpenCV 库#

终端执行以下命令安装 OpenCV 核心库：

Terminal window
pip install opencv-python

安装完成后，可通过以下命令验证安装是否成功：

Terminal window
pip show opencv-python

终端显示库版本、安装路径等信息，即代表安装成功。

二、完整摄像头调用代码#

以下为可直接运行的完整源码，适配 Windows/Mac 系统，实现三大核心功能：摄像头实时画面展示、S 键手动截图、ESC 键退出程序，代码简洁无冗余。

# 导入opencv核心库
import cv2


# 1. 初始化摄像头
# 参数0代表电脑默认内置摄像头，外接摄像头可尝试1、2、3依次测试
cap = cv2.VideoCapture(0)


# 判断摄像头是否成功打开
if not cap.isOpened():
    print("摄像头打开失败，请检查摄像头设备或权限！")
else:
    print("摄像头打开成功，按S键截图，按ESC键退出")


# 2. 循环读取摄像头实时画面
while True:
    # ret: 布尔值，是否读取到画面；frame: 每一帧画面的图像矩阵数据
    ret, frame = cap.read()


    # 读取画面失败则退出循环
    if not ret:
        print("读取画面失败，退出程序")
        break


    # 展示实时画面，窗口名称为 Camera Live
    cv2.imshow("Camera Live", frame)


    # 监听键盘按键（延迟1ms刷新画面）
    key = cv2.waitKey(1) & 0xFF


    # 按ESC键（键值27）退出程序
    if key == 27:
        break
    # 按S键保存当前画面截图
    elif key == ord('s'):
        # 截图保存至项目根目录
        cv2.imwrite("camera_screenshot.png", frame)
        print("截图成功！已保存为 camera_screenshot.png")


# 3. 释放硬件资源、关闭所有窗口
cap.release()
cv2.destroyAllWindows()

三、代码逐行详解#

1. 库导入与摄像头初始化#

  • import cv2：导入 OpenCV 核心视觉库，是所有图像、摄像头操作的基础前提。
  • cv2.VideoCapture(0)：初始化摄像头对象，参数为摄像头设备索引。0 为电脑默认内置摄像头，若连接外接 USB 摄像头，可修改参数为 1、2 依次测试适配。

2. 摄像头状态判断#

cap.isOpened()：检测摄像头设备是否正常开启，返回布尔值 True/False。可有效规避摄像头未连接、被其他软件占用、系统权限不足等问题导致的程序报错，提升代码稳定性。

3. 实时画面读取循环#

cap.read()：逐帧读取摄像头实时画面，返回两个核心参数：

  • ret：布尔值，True 代表成功读取画面，False 代表读取失败（摄像头断开、设备异常、被占用）。
  • frame：numpy 数组格式的图像数据，也就是摄像头捕捉到的每一帧画面，是后续展示、截图的核心数据。

4. 画面显示与按键监听#

  • cv2.imshow("窗口名", 画面数据)：创建可视化窗口，实时渲染展示摄像头画面。
  • cv2.waitKey(1)：等待键盘输入，参数 1 代表延迟 1 毫秒，保障画面持续刷新、实现实时预览效果。
  • 按键逻辑：通过匹配键盘键值，自定义功能——ESC 键（27）退出程序、S 键手动截图保存。

5. 资源释放（关键步骤）#

  • cap.release()：释放摄像头硬件资源，避免摄像头被程序持续占用，导致微信、浏览器、其他软件无法调用摄像头。
  • cv2.destroyAllWindows()：关闭所有 OpenCV 创建的图像窗口，彻底终止程序进程，避免后台残留。

四、运行效果说明#

  1. 代码运行后，自动弹出名为 Camera Live 的窗口，实时展示摄像头动态画面；
  2. 按下键盘 S 键，控制台输出截图成功提示，项目根目录自动生成 camera_screenshot.png 截图文件；
  3. 按下键盘 ESC 键，画面窗口关闭，摄像头资源释放，程序正常终止。

五、常见问题与解决方案#

1. 摄像头打开失败#

  • 常见原因：摄像头被微信、浏览器、直播软件等占用；摄像头设备索引错误；系统未开启摄像头权限。
  • 解决方案：关闭所有占用摄像头的软件；将 VideoCapture() 参数修改为 1/2 重新测试；在电脑系统设置中开启应用摄像头访问权限。

2. 画面黑屏、无实时画面#

  • 常见原因：摄像头硬件故障、电脑驱动异常、设备索引不匹配、帧读取逻辑异常。
  • 解决方案：重启电脑、更新摄像头驱动；核对并切换摄像头设备索引（0/1/2）。

3. 程序退出后摄像头仍被占用#

  • 原因：程序异常终止，未执行资源释放代码；进程后台残留。
  • 解决方案：确保代码末尾执行 cap.release() 和 cv2.destroyAllWindows()；强制终止后台 Python 进程后重启终端重新运行。

六、实操总结#

本次实操完成了 OpenCV 最基础的摄像头调用功能，熟练掌握了视觉开发的核心基础流程：

导入依赖库 → 初始化摄像头设备 → 循环读取画面帧 → 实时展示画面 → 监听自定义操作 → 释放硬件资源。

该功能是后续人脸识别、目标检测、视频录制、画面滤镜、图像抓拍等 OpenCV 视觉项目的核心基础，可在此代码框架上持续拓展更多实用功能。

因为原版文章没了，所以先让ai补了一篇，私密马赛

记录第一次使用opencv调用摄像头
http://mblog.linghantech.top/posts/记录第一次使用opencv调用摄像头/
作者
Mengdie
发布于
2026-09-12
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接，与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

基于qwen0.5b参数的训练