cv::cvtColor 用错颜色空间会导致全黑或花屏；必须确认Mat通道数和类型，BGR图用COLOR_BGR2GRAY，避免输入输出为同一Mat，灰度转换采用加权求和而非均值。
cv::cvtColor 用错颜色空间会导致全黑或花屏
直接调用 cv::cvtColor 但传入错误的源颜色空间（比如把 BGR 当成 RGB 或忽略 Mat 的实际通道数），图像会变成纯黑、偏色或内存越界崩溃。OpenCV 默认读图是 CV_8UC3 BGR 格式，不是 RGB；如果 Mat 来自 Qt、FFmpeg 或自定义内存，必须先确认 mat.channels() 和 mat.type()。
- 检查是否为三通道：
if (mat.channels() == 3)，再转灰度；单通道图（如已加载为IMREAD_GRAYSCALE）直接返回原图 - 强制指定源类型：即使图像是 RGB 数据，也得用
COLOR_RGB2GRAY；BGR 图像必须用COLOR_BGR2GRAY - 避免复用输出 Mat 内存：输入输出不能是同一 Mat 对象，否则行为未定义 ——
cv::cvtColor(src, src, COLOR_BGR2GRAY)是危险操作
灰度转换本质是加权求和，不是简单取均值
OpenCV 的 COLOR_BGR2GRAY 实际使用 ITU-R BT.601 标准系数：0.114 * B + 0.587 * G + 0.299 * R。这和直接用 cv::reduce(mat, gray, 1, CV_REDUCE_AVG) 得到的等权平均灰度图视觉差异明显，尤其在蓝色/红色区域。
- 需要精确复现某论文或旧系统逻辑时，别依赖
cvtColor，改用cv::transform配系数矩阵 - 实时性敏感场景（如嵌入式），可预分配好输出 Mat：
gray.create(mat.rows, mat.cols, CV_8UC1)，避免每次调用重复分配 - 浮点型 Mat（
CV_32FC3）需先转CV_8UC3再灰度，或用COLOR_BGR2GRAY的浮点变体（COLOR_BGR2GRAY本身支持 float 输入，但输出仍是CV_8UC1）
cv::imread 加载时就灰度化更高效
如果原始图像是磁盘文件且无需彩色中间结果，用 cv::imread(path, IMREAD_GRAYSCALE) 比先读彩色再转灰度快 20%~30%，省去内存拷贝与额外计算。
-
IMREAD_GRAYSCALE返回的是CV_8UC1，不是多通道降维后的伪灰度，通道数、步长（mat.step）都更紧凑 - 注意：该标志会忽略图像元数据中的色彩配置文件（ICC Profile），若需保色域，仍得先读彩色再转
- 从摄像头或视频流获取帧时，无法用此优化，只能靠
cvtColor
输出 Mat 的内存布局影响后续处理
灰度图是单通道，但它的 mat.step 可能不等于 mat.cols（尤其来自 ROI 或某些硬件解码器）。直接按行指针算地址（如 mat.ptr<uchar>(i)[j]</uchar>）没问题，但用 memcpy 整块拷贝或传给非 OpenCV 库时，得用 mat.step 而非 mat.cols 作为每行字节数。
- 安全遍历灰度图像素：
for (int i = 0; i (i); for (int j = 0; j - 导出到其他库（如 libjpeg-turbo）前，确保是连续内存：
if (!mat.isContinuous()) mat = mat.clone(); - OpenCV 的
CV_8UC1灰度图，像素值范围是 0–255，没有符号位，别误当成CV_8SC1
实际项目里最容易被跳过的，是确认输入 Mat 的真实类型和连续性 —— 尤其当图像来自第三方 SDK 或跨线程传递时，mat.empty() 为 false 不代表能直接喂给 cvtColor。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
