cv::cvtcolor是图像灰度化的唯一推荐方式，因其内置simd优化、自动适配bgr/rgb/bgra格式且处理alpha通道安全；手动加权平均易出错、低效且不支持多通道。
OpenCV 的 cv::cvtColor 是实现图像灰度化的标准方式，不是用 cv::threshold 或手写循环遍历像素——后者效率低、易出错、不支持多通道输入。
为什么必须用 cv::cvtColor 而不是自己算加权平均？
OpenCV 内部对灰度转换（如 BT.601 系数）做了 SIMD 优化和内存对齐处理，且自动适配 BGR/RGB/BGRA 等输入格式；手动实现容易忽略 alpha 通道、误用 RGB 顺序（OpenCV 默认是 BGR），还会在 ROI 或 ROI 子图上出错。
-
cv::cvtColor(src, dst, cv::COLOR_BGR2GRAY)是唯一推荐路径，src类型必须为CV_8UC3或CV_8UC4 - 若
src已是单通道（CV_8UC1），直接赋值即可，调用cvtColor会触发断言失败 - 灰度图输出始终为
CV_8UC1，不能指定目标深度（如CV_32F），需额外用convertScaleAbs或convertScale
cv::cvtColor 常见报错及修复
最典型的是 OpenCV(4.x): error: (-215:Assertion failed) scn == 3 || scn == 4 in function 'cvtColor'，说明输入图像通道数不对。
- 检查
src.channels()：读取图像时漏了cv::IMREAD_COLOR（默认是IMREAD_UNCHANGED，可能返回单通道） - 用
cv::imread("xxx.jpg", cv::IMREAD_COLOR)强制三通道读入，避免隐式降维 - 如果图像来自摄像头或 ROI 提取，确认没被
cv::cvtColor(..., COLOR_GRAY2BGR)反向污染过
灰度化后想保留原始图像结构怎么办？
灰度图是单通道，但某些后续操作（如叠加掩膜、显示伪彩色）需要与原图尺寸一致的三通道容器。不要用 cv::cvtColor(dst, dst3, cv::COLOR_GRAY2BGR) 后再处理——这纯属冗余拷贝。
立即学习“C++免费学习笔记（深入）”；
- 多数 OpenCV 函数（如
cv::threshold、cv::Canny）原生支持单通道输入，直接传dst即可 - 若必须三通道（如
cv::addWeighted混合原图与边缘图），用cv::cvtColor(dst, dst3, cv::COLOR_GRAY2BGR)，但仅在此处调用 - 避免反复转换：一次灰度化 + 多次单通道运算，比“灰度→BGR→处理→再灰度”快 3 倍以上（实测 1920×1080 图像）
真正要注意的是图像来源是否可靠——摄像头帧、视频解码器输出、网络接收的 raw data 都可能带 padding 或非标准 stride，这时候 cvtColor 不报错但结果偏色，得先用 cv::Mat::clone() 或 cv::Mat::copyTo() 确保连续内存布局。
