OpenCV-Python实战|模板匹配全解析:快速定位目标,新手也能一键上手(附完整代码)

python# 安装/升级OpenCV-Python（核心依赖）pip install opencv-python -U# 安装辅助库（图像显示、数据处理）pip install numpy matplotlib

pythonimport cv2import numpy as npimport matplotlib.pyplot as plt# 1. 读取目标图（含多个相似目标）和模板图（单个目标）target = cv2.imread("target.jpg", 0) # 目标图（灰度图），替换为自己的图像路径template = cv2.imread("template.jpg", 0) # 模板图（灰度图），替换为自己的图像路径# 2. 获取模板图的尺寸（后续用于绘制目标矩形）h, w = template.shape # h：模板高度，w：模板宽度print(f"模板尺寸：宽度{w}像素，高度{h}像素")# 显示目标图与模板图plt.subplot(1, 2, 1)plt.imshow(target, cmap="gray")plt.title("目标图（含多个相似目标）")plt.axis("off")plt.subplot(1, 2, 2)plt.imshow(template, cmap="gray")plt.title("模板图（单个目标）")plt.axis("off")plt.show()

pythoncv2.matchTemplate(image, templ, method)

匹配方法（method参数）

核心特点

适用场景

cv2.TM_CCOEFF_NORMED

归一化相关系数匹配，相似度范围[-1,1]，1表示完全匹配，-1表示完全不匹配

最常用，抗噪声、抗轻微亮度变化，适合大多数场景（新手首选）

cv2.TM_SQDIFF_NORMED

归一化平方差匹配，相似度范围[0,1]，0表示完全匹配，1表示完全不匹配

适合目标与背景对比度高、无噪声的场景

cv2.TM_CCORR_NORMED

归一化相关匹配，相似度范围[0,1]，1表示完全匹配

计算速度快，适合简单场景，抗噪声能力一般

cv2.TM_CCOEFF

未归一化相关系数匹配，相似度无固定范围，数值越大匹配度越高

不推荐新手使用，受亮度影响大

cv2.TM_SQDIFF

未归一化平方差匹配，数值越小匹配度越高

不推荐新手使用，受亮度、噪声影响大

cv2.TM_CCORR

未归一化相关匹配，数值越大匹配度越高

不推荐新手使用，抗干扰能力弱

cv2.TM_HAT_L2

基于Haar小波的匹配，抗噪声能力强，但计算速度慢

复杂噪声场景，对速度要求不高的场景

pythonimport cv2import numpy as npimport matplotlib.pyplot as plt# 1. 读取目标图和模板图（灰度图）target = cv2.imread("target.jpg", 0)template = cv2.imread("template.jpg", 0)h, w = template.shape# 2. 执行模板匹配（新手首选方法：cv2.TM_CCOEFF_NORMED）result = cv2.matchTemplate(target, template, cv2.TM_CCOEFF_NORMED)# 3. 找到相似度最高的位置（阈值可调整，一般取0.8，值越高匹配度要求越严格）threshold = 0.8# 找到所有相似度大于阈值的位置（返回坐标数组）locations = np.where(result >= threshold)# 4. 绘制矩形标注目标（单目标只需取第一个位置）# 将坐标转换为(x,y)格式（locations返回的是(y,x)，需调换顺序）x, y = zip(*locations[::-1])[0]# 绘制矩形：(x,y)为左上角坐标，(x+w, y+h)为右下角坐标，红色，线条粗细2target_color = cv2.cvtColor(target, cv2.COLOR_GRAY2BGR)cv2.rectangle(target_color, (x, y), (x + w, y + h), (0, 0, 255), 2)# 标注相似度cv2.putText(target_color, f"Match: {result[y, x]:.2f}", (x, y-10), cv2.FONT_HERSHEY_SIMPLEX, 0.8, (0, 0, 255), 2)# 显示效果（目标图 vs 模板图 vs 定位结果）plt.subplot(1, 3, 1)plt.imshow(target, cmap="gray")plt.title("目标图")plt.axis("off")plt.subplot(1, 3, 2)plt.imshow(template, cmap="gray")plt.title("模板图")plt.axis("off")plt.subplot(1, 3, 3)plt.imshow(cv2.cvtColor(target_color, cv2.COLOR_BGR2RGB))plt.title("单目标定位结果")plt.axis("off")plt.show()

pythonimport cv2import numpy as npimport matplotlib.pyplot as plt# 1. 读取目标图和模板图（灰度图）target = cv2.imread("target.jpg", 0)template = cv2.imread("template.jpg", 0)h, w = template.shape# 2. 执行模板匹配（沿用新手首选方法）result = cv2.matchTemplate(target, template, cv2.TM_CCOEFF_NORMED)threshold = 0.8locations = np.where(result >= threshold)# 3. 多目标定位：遍历所有匹配位置，去重（避免同一目标多次标注）target_color = cv2.cvtColor(target, cv2.COLOR_GRAY2BGR)# 将坐标转换为(x,y)格式，便于遍历x_list, y_list = zip(*locations[::-1])# 去重逻辑：相邻的匹配位置视为同一目标，保留一个used = [] # 记录已标注的位置，避免重复for i in range(len(x_list)):x, y = x_list[i], y_list[i]# 判断当前位置是否已标注（相邻位置差值小于模板宽度/高度的一半，视为同一目标）if not any(abs(x - ux) < w/2 and abs(y - uy) < h/2 for ux, uy in used):cv2.rectangle(target_color, (x, y), (x + w, y + h), (0, 255, 0), 2)cv2.putText(target_color, f"{result[y, x]:.2f}", (x, y-10), cv2.FONT_HERSHEY_SIMPLEX, 0.6, (0, 255, 0), 2)used.append((x, y))# 显示效果（目标图 vs 多目标定位结果）plt.subplot(1, 2, 1)plt.imshow(target, cmap="gray")plt.title("目标图（含多个相似目标）")plt.axis("off")plt.subplot(1, 2, 2)plt.imshow(cv2.cvtColor(target_color, cv2.COLOR_BGR2RGB))plt.title(f"多目标定位结果（共{len(used)}个目标）")plt.axis("off")plt.show()print(f"共找到{len(used)}个与模板匹配的目标")

pythonimport cv2import numpy as npimport matplotlib.pyplot as plt# 1. 读取目标图和模板图，添加噪声、改变亮度（模拟真实场景）target = cv2.imread("target.jpg", 0)template = cv2.imread("template.jpg", 0)h, w = template.shape# 模拟真实场景：添加高斯噪声、降低亮度def add_noise_and_adjust_brightness(img, noise_var=0.001, brightness=50):# 添加高斯噪声img = np.array(img/255, dtype=np.float32)noise = np.random.normal(0, noise_var**0.5, img.shape)img_noise = img + noiseimg_noise = np.clip(img_noise, 0, 1)img_noise = np.uint8(img_noise*255)# 降低亮度img_noise = cv2.addWeighted(img_noise, 1, np.zeros_like(img_noise), 0, -brightness)return img_noisetarget_noisy = add_noise_and_adjust_brightness(target)# 2. 图像预处理：高斯平滑（降噪）+ 灰度拉伸（增强对比度）target_processed = cv2.GaussianBlur(target_noisy, (3, 3), sigmaX=1) # 高斯平滑降噪# 灰度拉伸：增强对比度，提升匹配精度target_processed = cv2.equalizeHist(target_processed)# 3. 执行模板匹配（新手首选方法）result = cv2.matchTemplate(target_processed, template, cv2.TM_CCOEFF_NORMED)threshold = 0.75 # 噪声场景可适当降低阈值locations = np.where(result >= threshold)# 4. 多目标定位+去重target_color = cv2.cvtColor(target_noisy, cv2.COLOR_GRAY2BGR)x_list, y_list = zip(*locations[::-1]) if len(locations[0]) > 0 else ([], [])used = []for i in range(len(x_list)):x, y = x_list[i], y_list[i]if not any(abs(x - ux) < w/2 and abs(y - uy) < h/2 for ux, uy in used):cv2.rectangle(target_color, (x, y), (x + w, y + h), (255, 0, 0), 2)cv2.putText(target_color, f"{result[y, x]:.2f}", (x, y-10), cv2.FONT_HERSHEY_SIMPLEX, 0.6, (255, 0, 0), 2)used.append((x, y))# 显示效果（带噪声亮度变化图 vs 预处理后图 vs 定位结果）plt.subplot(1, 3, 1)plt.imshow(target_noisy, cmap="gray")plt.title("带噪声+亮度变化图")plt.axis("off")plt.subplot(1, 3, 2)plt.imshow(target_processed, cmap="gray")plt.title("预处理后图像")plt.axis("off")plt.subplot(1, 3, 3)plt.imshow(cv2.cvtColor(target_color, cv2.COLOR_BGR2RGB))plt.title(f"抗干扰定位结果（{len(used)}个目标）")plt.axis("off")plt.show()

pythonimport cv2import numpy as npimport matplotlib.pyplot as plt# 1. 环境验证（可选）print("OpenCV版本：", cv2.__version__)# 2. 辅助函数（加噪、亮度调整、预处理）def add_noise_and_adjust_brightness(img, noise_var=0.001, brightness=50):# 添加高斯噪声img = np.array(img/255, dtype=np.float32)noise = np.random.normal(0, noise_var**0.5, img.shape)img_noise = img + noiseimg_noise = np.clip(img_noise, 0, 1)img_noise = np.uint8(img_noise*255)# 调整亮度img_noise = cv2.addWeighted(img_noise, 1, np.zeros_like(img_noise), 0, -brightness)return img_noisedef preprocess_image(img):# 图像预处理：高斯平滑+灰度拉伸img_blur = cv2.GaussianBlur(img, (3, 3), sigmaX=1)img_processed = cv2.equalizeHist(img_blur)return img_processed# 3. 读取图像（替换为自己的图像路径）target = cv2.imread("target.jpg", 0)template = cv2.imread("template.jpg", 0)h, w = template.shapeif h > target.shape[0] or w > target.shape[1]:print("错误：模板图尺寸大于目标图，请更换模板图！")else:# 4. 单目标定位result_single = cv2.matchTemplate(target, template, cv2.TM_CCOEFF_NORMED)threshold_single = 0.8locations_single = np.where(result_single >= threshold_single)target_single = cv2.cvtColor(target, cv2.COLOR_GRAY2BGR)if len(locations_single[0]) > 0:x, y = zip(*locations_single[::-1])[0]cv2.rectangle(target_single, (x, y), (x+w, y+h), (0, 0, 255), 2)cv2.putText(target_single, f"Match: {result_single[y, x]:.2f}", (x, y-10), cv2.FONT_HERSHEY_SIMPLEX, 0.8, (0, 0, 255), 2)# 5. 多目标定位result_multi = cv2.matchTemplate(target, template, cv2.TM_CCOEFF_NORMED)threshold_multi = 0.8locations_multi = np.where(result_multi >= threshold_multi)target_multi = cv2.cvtColor(target, cv2.COLOR_GRAY2BGR)x_list, y_list = zip(*locations_multi[::-1]) if len(locations_multi[0]) > 0 else ([], [])used = []for i in range(len(x_list)):x, y = x_list[i], y_list[i]if not any(abs(x - ux) < w/2 and abs(y - uy) < h/2 for ux, uy in used):cv2.rectangle(target_multi, (x, y), (x+w, y+h), (0, 255, 0), 2)cv2.putText(target_multi, f"{result_multi[y, x]:.2f}", (x, y-10), cv2.FONT_HERSHEY_SIMPLEX, 0.6, (0, 255, 0), 2)used.append((x, y))# 6. 抗干扰匹配（带噪声、亮度变化）target_noisy = add_noise_and_adjust_brightness(target)target_processed = preprocess_image(target_noisy)result_anti = cv2.matchTemplate(target_processed, template, cv2.TM_CCOEFF_NORMED)threshold_anti = 0.75locations_anti = np.where(result_anti >= threshold_anti)target_anti = cv2.cvtColor(target_noisy, cv2.COLOR_GRAY2BGR)x_anti_list, y_anti_list = zip(*locations_anti[::-1]) if len(locations_anti[0]) > 0 else ([], [])used_anti = []for i in range(len(x_anti_list)):x, y = x_anti_list[i], y_anti_list[i]if not any(abs(x - ux) < w/2 and abs(y - uy) < h/2 for ux, uy in used_anti):cv2.rectangle(target_anti, (x, y), (x+w, y+h), (255, 0, 0), 2)cv2.putText(target_anti, f"{result_anti[y, x]:.2f}", (x, y-10), cv2.FONT_HERSHEY_SIMPLEX, 0.6, (255, 0, 0), 2)used_anti.append((x, y))# 7. 统一显示所有效果plt.figure(figsize=(15, 10))# 第一行：目标图、模板图、单目标定位plt.subplot(2, 3, 1)plt.imshow(target, cmap="gray")plt.title("目标图")plt.axis("off")plt.subplot(2, 3, 2)plt.imshow(template, cmap="gray")plt.title("模板图")plt.axis("off")plt.subplot(2, 3, 3)plt.imshow(cv2.cvtColor(target_single, cv2.COLOR_BGR2RGB))plt.title("单目标定位")plt.axis("off")# 第二行：多目标定位、带噪声图、抗干扰定位plt.subplot(2, 3, 4)plt.imshow(cv2.cvtColor(target_multi, cv2.COLOR_BGR2RGB))plt.title(f"多目标定位（{len(used)}个目标）")plt.axis("off")plt.subplot(2, 3, 5)plt.imshow(target_noisy, cmap="gray")plt.title("带噪声+亮度变化图")plt.axis("off")plt.subplot(2, 3, 6)plt.imshow(cv2.cvtColor(target_anti, cv2.COLOR_BGR2RGB))plt.title(f"抗干扰定位（{len(used_anti)}个目标）")plt.axis("off")plt.tight_layout()plt.show()# 8. 保存结果（可选）cv2.imwrite("template_single.jpg", target_single)cv2.imwrite("template_multi.jpg", target_multi)cv2.imwrite("template_anti.jpg", target_anti)