Qt5和Qt6摄像头API不兼容：Qt5用QCameraInfo枚举+QCamera/QCameraViewfinder，Qt6改用QMediaDevices+QMediaCaptureSession+QVideoWidget；黑屏主因是设备未正确枚举、后端缺失、权限不足或viewfinder设置不当，start()成功不等于画面输出。
直接调用 QCamera 启动摄像头，90% 的失败不是代码写错，而是设备没找对、后端没装好、权限没给足——start() 成功返回 ≠ 画面真出来。
先确认你用的是 Qt5 还是 Qt6？API 完全不兼容
Qt5 和 Qt6 的摄像头模块是两套独立实现，混用会链接失败或运行时崩溃：
- Qt5：用
QCameraInfo::availableCameras()枚举，QCamera+QCameraViewfinder+QCameraImageCapture - Qt6：废弃全部旧类，改用
QMediaDevices::videoInputs()+QCamera+QMediaCaptureSession+QVideoWidget
Qt6 还要额外 link multimediawidgets（QVideoWidget 在此模块），漏掉就报 “undefined reference to QVideoWidget::QVideoWidget”。
黑屏？先检查设备枚举和构造方式
别直接 new QCamera() —— 这会默认用系统“首选”设备，但该设备可能已被占用、权限拒绝、或根本不存在视频流输出能力。
正确做法是显式枚举并选一个可用设备：
// Qt5 示例
QList<QCameraInfo> cameras = QCameraInfo::availableCameras();
if (cameras.isEmpty()) {
qWarning() << "No camera found";
return;
}
QCamera *camera = new QCamera(cameras.first()); // 显式传入设备信息
关键点：
- 用
cameras.first()比用索引[0]更安全（避免空列表越界） - 设备描述名（
description()）比索引更可靠，热插拔后索引可能变，但设备 ID 不变 - Linux 下若返回空列表，大概率缺
gstreamer或后端插件（如gst-plugins-good）
预览黑屏的三大高频原因
即使 camera->start() 返回 true，画面仍可能黑。常见根因：
-
QCameraViewfinder必须在setViewfinder()前已创建且 parent 正确（不能是临时栈对象） - Windows 上未启用
Webcam权限（Win10/11 设置 → 隐私 → 相机 → 允许应用访问相机） - Linux 上未加用户到
video组：sudo usermod -aG video $USER，否则/dev/video*打不开 - Qt6 中忘记调
session->setVideoOutput(videoWidget)，只设camera不生效
调试技巧：监听 statusChanged 信号，打印状态值，QCamera::LoadedStatus 才代表设备真正就绪，QCamera::ActiveStatus 才能出帧。
截图花屏或为黑图？注意像素格式和线程安全
用 QCameraImageCapture::imageCaptured 拿到的 QImage，常见问题：
- 图像格式可能是
QImage::Format_RGB888，但某些设备输出 YUV（如 NV12），Qt 自动转换可能失败 → 黑图 - 回调在非 GUI 线程触发，直接
QImage::scaled()或塞进QLabel可能花屏 → 必须image.copy()后再跨线程传递 - Qt6 中
QImageCapture::readyForCaptureChanged信号比imageCaptured更早，适合做 UI 可用性控制
安全写法示例（Qt5）：
QObject::connect(imageCapture, &QCameraImageCapture::imageCaptured,
[=](int id, const QImage &img) {
QImage safeImg = img.copy(); // 关键：copy 避免跨线程引用失效
QPixmap pm = QPixmap::fromImage(safeImg.scaled(label->size(), Qt::KeepAspectRatio));
label->setPixmap(pm);
});
最易被忽略的一点：QCamera 析构前必须调 stop()，否则下次启动可能因设备未释放而失败——这不是内存泄漏，是硬件资源锁死。
