Pyautogui图像搜索哪种更快：全屏单次搜索还是多指定区域搜索

核心影响因素 #

PyAutoGUI的locateOnScreen底层基于OpenCV模板匹配，耗时由两部分组成：

• 单次调用的固定开销：包括截图触发、参数校验、内存初始化等操作，每次调用都会产生，和搜索区域大小无关，单次开销一般在几毫秒到几十毫秒级别，和硬件配置相关。
• 模板匹配的可变耗时：和搜索区域的像素总量成正比，搜索面积越大，这部分耗时越高。

两种方案的速度对比 #

• 当5个目标区域的总占比 ≤ 40% 时，分区域搜索速度更快：搜索面积减少带来的耗时降低，完全覆盖多出来的4次调用的额外开销。
• 当5个目标区域的总占比 ≥ 60% 时，单次全屏搜索速度更快：面积减少的收益不足以抵消多次调用的固定开销损耗。
• 40%~60%为浮动区间：具体阈值受屏幕分辨率、目标模板图大小、置信度参数影响：高分辨率屏幕、小尺寸模板图的场景下，阈值会向60%侧偏移；低分辨率、大尺寸模板图的场景下，阈值会向40%侧偏移。

如果你的场景确定目标每次只会出现在一个区域，可以在分区搜索时增加逻辑：找到目标后直接终止剩余区域的搜索，这个优化可以把阈值再提高10%左右。

实用验证方案 #

后续可以测试的时候，直接跑简单的耗时统计代码就能得到适配你场景的精准阈值，示例代码如下：

import pyautogui
import time

# 待搜索的目标图路径
TARGET_IMG = "your_target.png"
# 你的5个目标区域，格式为(左上角x, 左上角y, 宽度, 高度)
TARGET_REGIONS = [(x1,y1,w1,h1), (x2,y2,w2,h2), (x3,y3,w3,h3), (x4,y4,w4,h4), (x5,y5,w5,h5)]
TEST_TIMES = 10

# 测试全屏搜索耗时
start = time.time()
for _ in range(TEST_TIMES):
    pyautogui.locateOnScreen(TARGET_IMG, confidence=0.8)
full_screen_avg = (time.time() - start) / TEST_TIMES
print(f"单次全屏搜索平均耗时：{full_screen_avg:.4f}s")

# 测试分区搜索耗时
start = time.time()
for _ in range(TEST_TIMES):
    for region in TARGET_REGIONS:
        res = pyautogui.locateOnScreen(TARGET_IMG, region=region, confidence=0.8)
        if res:
            break
region_avg = (time.time() - start) / TEST_TIMES
print(f"分区搜索平均耗时：{region_avg:.4f}s")

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