cv::cvtColor(src, dst, cv::COLOR_BGR2GRAY) 是正确用法；CV_BGR2GRAY 已废弃，输入必须为3通道BGR图像（CV_8UC3），否则触发断言失败。
cv::cvtColor(src, dst, CV_BGR2GRAY) 是错的
OpenCV 4.x 中根本不存在 CV_BGR2GRAY 这个常量，它早在 3.0 就被废弃了。用它会编译失败，报错类似：‘CV_BGR2GRAY’ was not declared in this scope。正确常量是 cv::COLOR_BGR2GRAY，注意前缀和大小写。
另外，cv::cvtColor 要求输入必须是 3 通道 BGR 图（CV_8UC3），如果传入已经是灰度图（CV_8UC1）或 RGBA（CV_8UC4），会触发运行时断言失败，错误信息通常是：OpenCV(4.x): error: (-215:Assertion failed) scn == 3 || scn == 4 in function 'cvtColor'。
- 确认输入
src类型：std::cout ，输出 <code>16表示 BGR（CV_8UC3） - 输出
0表示灰度（CV_8UC1），此时无需转换，直接赋值即可：dst = src.clone(); - 若为
CV_8UC4（如从 PNG 读入），先用cv::cvtColor(src, temp, cv::COLOR_BGRA2BGR)降为 3 通道再转灰度
为什么不能直接用 cv::cvtColor(src, dst, cv::COLOR_RGB2GRAY)
因为 OpenCV 默认按 BGR 顺序解释三通道图像 —— 即使你用 cv::imread("xxx.jpg") 读图，结果也是 BGR 格式，不是 RGB。如果误用 cv::COLOR_RGB2GRAY，色彩通道会被错位映射（R→G、G→B、B→R），导致灰度值计算错误，图像明显偏暗或发青。
只有当你明确知道输入 Mat 的 channel 顺序是 RGB（比如从某些第三方库传来、或手动构造并保证顺序），才该用 cv::COLOR_RGB2GRAY。绝大多数情况，包括 cv::imread、摄像头采集、cv::VideoCapture 输出，都应使用 cv::COLOR_BGR2GRAY。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 检查来源：如果图来自
cv::imread(path, cv::IMREAD_COLOR)，一定用cv::COLOR_BGR2GRAY - 不确定时，可用
cv::cvtColor(src, test, cv::COLOR_BGR2RGB)后 imshow 验证——若颜色正常，说明原图确实是 BGR -
cv::COLOR_BGR2GRAY内部按 0.114×B + 0.587×G + 0.299×R 加权，符合人眼感知
单行安全转换写法（推荐）
避免临时变量、类型检查和异常分支，用以下方式最稳妥：
cv::Mat gray;
if (src.channels() == 3) {
cv::cvtColor(src, gray, cv::COLOR_BGR2GRAY);
} else if (src.channels() == 1) {
gray = src.clone();
} else if (src.channels() == 4) {
cv::Mat bgr;
cv::cvtColor(src, bgr, cv::COLOR_BGRA2BGR);
cv::cvtColor(bgr, gray, cv::COLOR_BGR2GRAY);
}
注意：不要写成 gray = src;（浅拷贝），后续修改 src 会影响 gray；clone() 是必须的。
- 如果确定只处理标准 JPEG/BMP 输入（必为 BGR 或灰度），可省略 channels 判断，但上线前务必实测各种来源
- 性能敏感场景（如实时视频处理），提前缓存
src.channels()结果，避免重复调用 - 不建议用
cv::IMREAD_GRAYSCALE参数重读——浪费 I/O 和内存，且无法复用已有 Mat 对象
cv::cvtColor 转灰度后 dst 的 type 是什么？
输出 dst 的 type 固定为 CV_8UC1（即单通道 8 位无符号整数），无论输入是 CV_8UC3 还是 CV_8UC4。这意味着：
- 不能直接对
gray使用cv::cvtColor(..., cv::COLOR_GRAY2BGR)反向转换 —— 那是另一个操作，且需确保目标 Mat 已分配合适尺寸和类型 - 后续如做
cv::threshold或cv::findContours，它们都要求CV_8UC1，所以这一步是必要前置 - 如果需要 float 型灰度图（如用于某些滤波），得手动转换：
gray.convertScaleAbs(dst_float, 1.0/255.0);或用gray.convertTo(dst_float, CV_32F);
最容易被忽略的是：很多人以为转完灰度就“完成任务”，但没检查 gray.empty() —— 如果 src 是空 Mat 或尺寸为 0，cvtColor 不报错但输出仍是空，后续操作直接崩溃。实际代码中，if (src.empty()) return; 应该是第一道防线。
