pyautogui.locateAll识别单张目标图像时返回大量重复位置如何解决

1. pyautogui的模板匹配采用滑动窗口逐像素扫描的逻辑，当置信度阈值设置偏低时，相邻位置的滑动窗口匹配得分都能超过阈值，就会输出大量仅偏移1-2像素的重复Box结果。
2. 你使用的标记图是带透明通道的PNG格式，匹配JPG格式的屏幕截图时，边缘半透明像素的匹配容错率更高，进一步放大了重复命中的问题。
3. 你感知到程序不会自动停止，本质是大量重复结果持续输出导致的控制台打印阻塞，并非程序真的进入死循环。
4. 仅调整confidence参数无法解决问题的原因是该参数和匹配结果并非线性对应：阈值过高会过滤掉所有正确匹配，阈值过低就会出现大量重复结果，无法通过单一参数平衡召回率和去重效果。

• 方案一：最简去重逻辑（无需额外依赖）
  开启灰度匹配减少误判，同时对匹配结果的中心坐标做距离校验，重叠范围超过标记尺寸一半的结果判定为同一个目标，直接去重。

import pyautogui
import math

marker_path = "C:/Users/User/Desktop/python/bot/MarkerTransparent2.PNG"
# 提前获取标记图的宽高作为去重阈值参考
marker_width, marker_height = pyautogui.size(marker_path)
valid_positions = []

# 新增grayscale=True参数，灰度匹配速度更快、误判更少
for pos in pyautogui.locateAll(
    marker_path,
    "C:/Users/User/Desktop/python/bot/locate_markers.PNG",
    confidence=0.6,
    grayscale=True
):
    center_x, center_y = pyautogui.center(pos)
    # 检查当前匹配结果和已保存的有效结果是否重叠
    is_duplicate = False
    for (saved_x, saved_y) in valid_positions:
        # 两点距离小于标记宽度的1/2时判定为同一个目标
        if math.hypot(center_x - saved_x, center_y - saved_y) < marker_width / 2:
            is_duplicate = True
            break
    if not is_duplicate:
        valid_positions.append((center_x, center_y))
        print(pos)

如果不需要保存截图到本地，也可以直接用locateAllOnScreen接口直接在当前屏幕匹配，无需本地IO，运行效率更高：

for pos in pyautogui.locateAllOnScreen(marker_path, confidence=0.6, grayscale=True):
    # 后续去重逻辑和上面一致

• 方案二：更高精度匹配（需安装OpenCV依赖）
  如果需要更稳定的匹配效果，可以直接调用OpenCV的模板匹配接口，搭配非极大值抑制（NMS）逻辑过滤重复框，同时支持更高的自定义配置空间。

内容的提问来源于stack exchange，提问作者Ben Wientges