需确保模板不大于目标图、输入为单通道灰度图并归一化；检查result尺寸是否符合rows=img.rows-templ.rows+1；用阈值筛选+非极大值抑制提取多个匹配位置。
OpenCV的matchTemplate函数怎么调用才不返回空结果？
直接调用matchTemplate却得不到有效坐标，大概率是模板和目标图尺寸/类型不匹配，或没做归一化预处理。它只接受CV_8U或CV_32F单通道图像，输入前必须用cvtColor转灰度，再用convertScaleAbs或normalize确保像素值在合理范围。
- 模板图像不能比目标图大，否则
matchTemplate会静默失败，返回空矩阵 - 务必检查
result矩阵尺寸：result.rows == img.rows - templ.rows + 1，否则说明输入有误 - 若用
CV_TM_CCOEFF_NORMED方法，匹配值范围是[-1,1]，可靠阈值通常设为0.7以上
如何从minMaxLoc结果里提取多个匹配位置？
minMaxLoc只返回全局最值点，但实际场景常需多个相似区域。得自己遍历result矩阵，按阈值筛选坐标，再用非极大值抑制（NMS）去重。
- 遍历时用
for (int y = 0; y 逐行扫描，避免<code>at<float>()</float>越界 - NMS半径建议设为模板宽高的
max(templ.cols, templ.rows) / 4，太小留冗余，太大漏检 - 别直接用
Point存坐标——要加回模板左上角偏移：Point(x + templ.cols/2, y + templ.rows/2)才是中心点
为什么匹配坐标总偏移几个像素？
根本原因是matchTemplate输出的result中，位置(x,y)对应模板**左上角**在原图的落点，而非中心。多数应用需要中心坐标，必须手动补偿。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 若模板尺寸为奇数（如
31x31），中心偏移就是Point(15,15)；偶数尺寸（如32x32）则用Point(16,16) - 用
cv::Rect画框时，左上角应为Point(x, y)，右下角为Point(x + templ.cols, y + templ.rows)，别混淆 - 亚像素精度可后续用
cv::findCornersSubPix优化，但前提是模板边缘清晰且光照均匀
C++里怎么安全释放matchTemplate用到的Mat内存？
OpenCV的Mat是引用计数的，只要不显式调用release()，离开作用域自动析构。但容易踩坑的是：把result传给其他函数时，如果对方做了clone()或copyTo()，原始Mat仍有效；反之若对方用了create()覆盖，原内存可能被回收。
- 模板匹配前后都用
img.empty() || templ.empty()做前置校验，避免空指针崩溃 - 调试时打印
result.type()确认是CV_32F，不是CV_8U（后者会导致minMaxLoc解析错误） - 多线程环境下，每个线程必须独立创建
resultMat，不可共用同一块内存
模板匹配真正难的不是调API，而是理解result矩阵每个像素代表什么、阈值怎么定、坐标怎么映射回原图——这些细节错一点，结果就漂移或漏检。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
