cv::threshold 使用 Otsu 必须显式传入 CV_THRESH_OTSU 标志，且需与 CV_THRESH_BINARY 等二值化模式组合；仅适用于单通道灰度图，返回值为计算所得阈值而非状态标志。
cv::threshold 用 Otsu 必须传入 CV_THRESH_OTSU 标志
OpenCV 的 cv::threshold 支持 Otsu 自动阈值，但不是默认行为——必须显式指定标志位，否则它只做普通固定阈值分割。常见错误是漏掉这个标志，结果得到的阈值始终是输入的 thresh 值，Otsu 完全没生效。
实操要点：
- Otsu 只适用于单通道灰度图，传入彩色图会报错或输出异常结果，务必先用
cv::cvtColor转成CV_8UC1 -
thresh参数在启用 Otsu 时可设为任意值（如0或127），实际阈值由函数内部计算并返回，不要依赖输入值 - 函数返回值是实际选中的 Otsu 阈值（
double类型），不是布尔状态，别把它当成功/失败标志用
为什么 cv::THRESH_OTSU 和 cv::THRESH_BINARY 要一起用
Otsu 是一种阈值“计算策略”，不是独立的分割模式。它必须和某个二值化类型组合使用，最常用的是 cv::THRESH_BINARY（大于阈值置 255，否则置 0）。单独传 cv::THRESH_OTSU 会触发断言失败或未定义行为。
典型写法：
cv::Mat gray, binary; cv::cvtColor(src, gray, cv::COLOR_BGR2GRAY); double otsu_thresh = cv::threshold(gray, binary, 0, 255, cv::THRESH_BINARY | cv::THRESH_OTSU);
其他组合也合法，比如 cv::THRESH_BINARY_INV（反色二值），但 cv::THRESH_TRUNC 或 cv::THRESH_TOZERO 等非二值模式与 Otsu 无实际意义，OpenCV 不禁止但逻辑上不匹配。
Otsu 失效的三个典型场景
Otsu 假设图像直方图是双峰分布（前景+背景各一个主峰），一旦不满足，算出的阈值可能完全偏离预期。
容易踩坑的情况：
- 图像整体过暗或过亮，直方图严重偏左/右，缺乏明显双峰结构
- 目标区域占比极小（如一张大背景里只有几个像素的目标），Otsu 会把阈值压向背景主导侧
- 噪声过大导致直方图毛刺多、峰不清晰，Otsu 对噪声敏感，结果抖动大
应对建议：先用 cv::GaussianBlur 或 cv::medianBlur 平滑降噪；若目标太小，考虑先用形态学或 ROI 提前聚焦区域；实在不行就换 cv::adaptiveThreshold。
cv::threshold 返回值不是 bool，别用来判断是否成功
很多初学者看到返回值就以为是成功标志，其实 cv::threshold 总是返回一个 double——就是它算出来的阈值。哪怕你传了非法参数（比如非单通道图），它也可能静默处理或崩溃，而不是返回特殊值提示错误。
真正该检查的是输入 Mat 的属性：
- 确保
gray.depth() == CV_8U且gray.channels() == 1 - 运行前加一句
CV_Assert(!gray.empty() && gray.depth() == CV_8U && gray.channels() == 1);能早发现问题 - 如果需要调试 Otsu 结果，用
cv::calcHist手动画直方图，肉眼确认双峰是否存在
Otsu 看似一行代码搞定，但背后依赖图像统计特性，阈值是否合理得靠直方图说话，不能只信返回值数字。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
