cv::videocapture 是跨平台获取摄像头帧最稳定的选择，自动适配各系统后端，但需注意设备索引、权限、属性设置有效性及格式（默认bgr）等问题。
用 OpenCV 的 cv::VideoCapture 打开摄像头最直接
Windows/macOS/Linux 上想快速拿到视频帧，cv::VideoCapture 是目前最稳的选择。它底层自动适配平台（Windows 用 MSMF 或 DShow，Linux 用 V4L2，macOS 用 AVFoundation），不用自己折腾驱动或编解码器。
常见错误是传错设备索引：cv::VideoCapture cap(0) 中的 0 不一定对应“第一个物理摄像头”——有些笔记本会把虚拟摄像头（如 Zoom 虚拟背景）排在前面，或者系统更新后索引偏移。建议先用 cap.open(0) + cap.isOpened() 检查，失败就试 1、2，最多试到 5。
- 如果
cap.isOpened()返回false，但设备明明在工作，大概率是权限问题（macOS 需在Info.plist加摄像头权限；Linux 可能要加用户到video组） -
cap.set(cv::CAP_PROP_FRAME_WIDTH, 1280)这类设置不一定生效，不同后端支持的属性不同，设完要用cap.get()回读确认 - 默认使用 BGR 格式，不是 RGB —— 后续做 OpenCV 图像处理没问题，但传给 OpenGL 或 Qt 显示前得注意颜色通道顺序
不依赖 OpenCV 时，C++ 原生调用要看平台
OpenCV 太重？或者项目禁用第三方库？那就得按平台走原生路径：Windows 用 Media Foundation（推荐，Win7+），Linux 用 V4L2（需 ioctl + mmap），macOS 用 AVFoundation（Objective-C++ 混合编译）。
这些方案共性是：代码量翻倍、错误分支多、调试困难。比如 V4L2 中 VIDIOC_S_FMT 返回 EINVAL，可能是分辨率不被硬件支持，也可能是没先 VIDIOC_REQBUFS；Media Foundation 中 MFStartup 忘调或重复调用会导致 E_UNEXPECTED。
立即学习“C++免费学习笔记（深入）”；
- Media Foundation 要求 Windows SDK ≥ 8.1，且工程必须定义
WIN32_LEAN_AND_MEAN避免头文件冲突 - V4L2 设备路径通常是
/dev/video0，但某些 USB 摄像头可能映射成/dev/video10，用ls /dev/video*确认 - AVFoundation 必须用
.mm后缀，且 C++ 类里不能直接存AVCaptureSession*，得用void*或std::unique_ptr包一层再桥接
cv::VideoCapture 卡顿、掉帧、延迟高怎么调
不是摄像头不行，往往是默认参数没调对。OpenCV 默认用“自动模式”，实际会频繁切换曝光、白平衡，导致帧率跳变甚至卡死。
关键动作是关掉所有自动控制，并手动设好缓冲区和采集格式：
- 在
cap.open()后立刻加cap.set(cv::CAP_PROP_AUTO_EXPOSURE, 0.25)（OpenCV 的 0.25 表示关闭自动曝光，不是布尔值） - 用
cap.set(cv::CAP_PROP_BUFFERSIZE, 1)把缓冲区压到最小，减少排队延迟（但会增加丢帧风险） - 显式指定编码格式：比如
cap.set(cv::CAP_PROP_FOURCC, cv::VideoWriter::fourcc('M', 'J', 'P', 'G'))，绕过默认 YUYV 转 BGR 的 CPU 耗时 - 如果只要灰度图，用
cap.set(cv::CAP_PROP_CONVERT_RGB, false)+cv::cvtColor(frame, gray, cv::COLOR_BGR2GRAY)比让 OpenCV 自动转更可控
跨平台打包时摄像头打不开的典型原因
开发机上跑得好好的，发给同事或打包进 Docker 就黑屏——八成是运行时缺失依赖或权限链断了。
Linux 下最常踩的坑是：静态链接 OpenCV 后，libavcodec、libv4l2 这些动态依赖没打进包里；macOS 上则是打包后 Info.plist 权限声明丢失，或者签名破坏了摄像头 entitlement；Windows 则容易漏掉 mfplat.dll、mfreadwrite.dll 等 Media Foundation 动态库。
- Docker 容器要加
--device=/dev/video0和--group-add video，否则连设备节点都看不到 - macOS App 打包后，用
codesign --entitlements重签时必须保留com.apple.security.device.camera权限项 - Windows 应用若用 MSVC 编译，发布目录下缺
vcruntime140.dll或msvcp140.dll，cv::VideoCapture构造就会静默失败
真正在意稳定性和兼容性的话，别只测“能不能打开”，得在目标机器上实测连续采集 10 分钟有没有卡顿、重启系统后是否还能自动识别设备、拔插摄像头会不会崩溃——这些才是现场最容易爆的点。
