OpenCV调用摄像头报错：相机索引超出范围，代码无法运行求助

架构老林

2026-6-29

解决OpenCV“相机索引超出范围”问题

针对你遇到的相机索引报错，按以下步骤排查：

先确认系统可用的相机索引
运行以下脚本遍历可能的索引，找到能正常打开的相机：

import cv2
for idx in range(6):
    cap = cv2.VideoCapture(idx)
    if cap.isOpened():
        print(f"✅ 相机索引 {idx} 可用")
        cap.release()
    else:
        print(f"❌ 相机索引 {idx} 不可用")

把原代码中的0替换成输出里显示可用的索引再测试。

指定摄像头后端
不同操作系统的摄像头后端兼容问题可能导致无法打开，尝试强制指定后端：
- Windows系统：
```
cam = cv2.VideoCapture(0, cv2.CAP_MSMF)
```
- Linux系统：
```
cam = cv2.VideoCapture(0, cv2.CAP_V4L2)
```
- macOS系统：
```
cam = cv2.VideoCapture(0, cv2.CAP_AVFOUNDATION)
```
检查摄像头是否被占用
关闭所有可能占用摄像头的应用（微信、Zoom、浏览器视频通话等），这些应用会独占摄像头资源，导致OpenCV无法调用。
验证OpenCV安装完整性
如果你安装的是opencv-python-headless版本，它不包含摄像头和GUI支持，需要替换为完整版：
```
pip uninstall opencv-python-headless
pip install opencv-python
```
也可以尝试更新到最新版OpenCV：
```
pip install --upgrade opencv-python
```
排查硬件/驱动问题
先在系统自带的相机应用中测试（Windows相机、Mac Photo Booth），如果系统应用也无法打开摄像头，说明是硬件故障或驱动问题，需要更新摄像头驱动或检查硬件连接。