Mat转QImage需同步通道顺序、内存生命周期和像素格式：先用cv::cvtColor转BGR→RGB/RGBA，再用mat.clone()或延长Mat生命周期确保内存有效，最后按mat.type()匹配QImage格式并传正确step[0]。
Mat转QImage时通道顺序不匹配导致颜色异常
OpenCV默认使用BGR顺序，而QImage默认是RGB，直接用QImage构造函数套用Mat.data会得到偏蓝或偏红的图像。必须显式转换通道顺序，最稳妥的是用cv::cvtColor转成RGB或RGBA。
- 若
mat.type() == CV_8UC3（三通道），先调用cv::cvtColor(mat, rgb_mat, cv::COLOR_BGR2RGB)再构造QImage - 若需透明通道（如后续要贴到带alpha的QWidget上），用
cv::COLOR_BGR2BGRA，然后用QImage::Format_ARGB32 - 避免用
cv::COLOR_BGR2RGB后手动memcpy——QImage内部可能做字节对齐，直接传rgb_mat.data更安全
QImage构造时内存生命周期必须受控
QImage构造函数接受裸指针，但**不会接管内存所有权**。如果Mat是局部变量、临时结果或会在QImage使用前释放，QImage会访问野指针，表现为花屏、崩溃或随机色块。
- 方案一：用
mat.clone()确保数据独立，再传mat_clone.data——适合小图或不频繁调用 - 方案二：将
Mat成员变量声明在类里（如QLabel子类中），保证其生命周期 ≥ QImage生命周期 - 方案三：用
QImage的copy()方法（如QImage(mat.data, w, h, ...).copy()），生成深拷贝，但注意性能开销
不同Mat类型对应QImage格式不能硬编码
不是所有Mat都能直接喂给同一个QImage构造签名。类型不匹配会导致宽度错位、颜色错乱甚至段错误。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
CV_8UC1→QImage::Format_Grayscale8（Qt 5.14+）或QImage::Format_Indexed8（旧版需配调色板） -
CV_8UC3→QImage::Format_RGB888（仅当已转RGB） -
CV_8UC4→QImage::Format_RGBA8888或QImage::Format_ARGB32（注意ARGB是 premultiplied alpha，需确认是否符合需求） - 务必用
mat.type()和mat.elemSize()校验，别只看通道数
Qt6下QImage构造参数变化易引发编译失败
Qt6移除了部分QImage构造函数重载，比如不再支持QImage(uchar*, int, int, int, QImage::Format)中步长（bytesPerLine）为0的写法。OpenCV的Mat.step可能不是width * channels（因内存对齐），直接传mat.step比硬算更可靠。
立即学习“C++免费学习笔记（深入）”；
- Qt6必须显式传
mat.step[0]作为bytesPerLine参数，不能省略或填0 - 若
mat.isContinuous()为false（如ROI提取后），需先mat = mat.clone()再转，否则data不连续，QImage读取会错行 - Qt6推荐用
QImage::Format_RGBX8888替代Format_RGB888（后者被标记为deprecated）
QImage的像素格式、内存所有权、Mat数据连续性这三点，任何一个没对齐都会当场出问题，而不是“看起来差不多”。调试时优先检查mat.type()输出和qDebug() << qimage.format()是否一致，比猜更快。
