如何利用pyautogui实现等待屏幕上特定图像出现的功能？

嘿，刚好碰到过类似的场景！PyAutoGUI本身确实没有像pywinauto那样直接的wait_until()方法，但我们可以通过两种实用方式实现等待特定图像出现的功能，完美解决你因为图像加载慢导致的报错问题。

方法一：手动实现循环等待（兼容所有PyAutoGUI版本） #

如果你的PyAutoGUI版本偏旧，或者想完全自定义等待逻辑，可以写一个简单的循环函数，不断检查屏幕上是否出现目标图像，直到找到或者超时：

import pyautogui
import time

def wait_for_image(image_path, timeout=30, check_interval=0.5):
    """
    等待屏幕上出现指定图像
    :param image_path: 参考图像的路径（脚本目录下直接写文件名即可）
    :param timeout: 最长等待时间（秒）
    :param check_interval: 每次检查的间隔时间（秒）
    :return: 图像在屏幕上的位置对象
    """
    start_time = time.time()
    while time.time() - start_time < timeout:
        # 尝试定位图像
        image_location = pyautogui.locateOnScreen(image_path)
        if image_location is not None:
            return image_location
        # 间隔一段时间再检查，避免占用过多CPU资源
        time.sleep(check_interval)
    # 超时后抛出异常
    raise Exception(f"超时！在{timeout}秒内未找到图像：{image_path}")

# 使用示例
try:
    # 等待目标图像出现，最多等15秒
    target_loc = wait_for_image("your_reference_image.png", timeout=15)
    # 找到图像后执行后续操作，比如点击图像中心
    pyautogui.click(pyautogui.center(target_loc))
except Exception as e:
    print(e)

方法二：使用PyAutoGUI内置的超时参数（推荐，更简洁） #

从PyAutoGUI 0.9.50版本开始，locateOnScreen()函数新增了timeout参数，支持直接设置最长等待时间，超时会抛出ImageNotFoundException异常，用起来更省心：

import pyautogui

try:
    # 等待最多10秒，找到图像就返回位置；找不到就抛出异常
    target_loc = pyautogui.locateOnScreen("your_reference_image.png", timeout=10)
    # 执行后续操作
    pyautogui.click(pyautogui.center(target_loc))
except pyautogui.ImageNotFoundException:
    print("错误：目标图像在10秒内未加载完成")

额外优化：提高图像匹配的容错率 #

如果你的目标图像因为版本差异有轻微视觉变化（比如按钮颜色、文字微调），可以通过confidence参数设置匹配精度（需要先安装opencv-python）：

pip install opencv-python

然后修改代码：

target_loc = pyautogui.locateOnScreen(
    "your_reference_image.png",
    timeout=10,
    confidence=0.8  # 匹配度80%以上就认定找到，数值范围0-1
)

注意事项 #

• 确保你的Python3.6能安装对应版本的PyAutoGUI：pip install pyautogui>=0.9.50（PyAutoGUI 0.9.50+支持Python3.6）
• 参考图像要尽量清晰，避免包含过多无关背景，能有效提高识别成功率

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