0

0

PyAutoGUI图像查找失败时为何抛异常?三种优雅处理方案详解

花韻仙語

花韻仙語

发布时间:2026-01-10 22:25:02

|

908人浏览过

|

来源于php中文网

原创

PyAutoGUI图像查找失败时为何抛异常?三种优雅处理方案详解

pyautogui自0.9.41版起,`locateonscreen()`在未找到图像时默认抛出`imagenotfoundexception`而非返回`none`,因此直接用`if ... != none`判断会中断程序;本文介绍`try/except`、`locateallonscreen + next()`及封装函数三种健壮处理方式。

PyAutoGUI 的图像定位功能(如 locateOnScreen())设计上遵循“显式优于隐式”的 Python 哲学:当目标图像未被识别时,它主动抛出 pyautogui.ImageNotFoundException 异常,而非静默返回 None。这种设计能帮助开发者及时发现图像路径错误、截图质量差、屏幕缩放不匹配或 confidence 阈值设置过高等真实问题,避免因误判 None 而掩盖逻辑缺陷。

虽然问题中希望“不使用 try/except”,但需明确:捕获 ImageNotFoundException 是官方推荐且最直观的惯用做法。它语义清晰、性能高效、符合 Python 异常处理最佳实践:

import pyautogui
import time

while True:
    try:
        # 若找到图像,返回 Box 对象(left, top, width, height)
        location = pyautogui.locateOnScreen("1.png", confidence=0.9)
        print("I can see it")
    except pyautogui.ImageNotFoundException:
        print("I cannot see it")
    time.sleep(0.5)

若坚持避免 try/except,可借助 locateAllOnScreen() —— 它返回一个生成器(generator),在无匹配时为空,不会抛异常。配合内置 next() 函数并提供默认值 None,即可安全判断:

VIVA
VIVA

一个免费的AI创意视觉设计平台

下载
import pyautogui
import time

while True:
    # locateAllOnScreen() 总是返回生成器;next(..., None) 在生成器为空时返回 None
    if next(pyautogui.locateAllOnScreen("1.png", confidence=0.9), None) is not None:
        print("I can see it")
    else:
        print("I cannot see it")
    time.sleep(0.5)
⚠️ 注意:locateAllOnScreen() 会扫描全屏所有匹配项,性能略低于 locateOnScreen()(后者找到首个即停)。若仅需检测存在性,此方案可行;但若后续还需坐标信息,建议仍用 try/except 并保留 location 变量。

更进一步,可封装一个兼容旧行为的工具函数,统一抽象异常逻辑:

def safe_locate(image_path, **kwargs):
    """安全调用 locateOnScreen,找不到时返回 None"""
    try:
        return pyautogui.locateOnScreen(image_path, **kwargs)
    except pyautogui.ImageNotFoundException:
        return None

# 使用示例
while True:
    if safe_locate("1.png", confidence=0.9):
        print("I can see it")
    else:
        print("I cannot see it")
    time.sleep(0.5)

总结:不要将异常视为“错误”,而应视其为 PyAutoGUI 提供的关键反馈机制。优先采用 try/except 方案;若需链式调用或函数式风格,locateAllOnScreen + next() 是简洁替代;长期项目中,封装 safe_locate 可提升代码复用性与可读性。同时务必检查图像文件路径、DPI 缩放设置(Windows/macOS)、后台窗口遮挡及 confidence 参数(建议 0.7–0.95 区间调试)。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

846

2023.08.22

location.assign
location.assign

在前端开发中,我们经常需要使用JavaScript来控制页面的跳转和数据的传递。location.assign就是JavaScript中常用的一个跳转方法。通过location.assign,我们可以在当前窗口或者iframe中加载一个新的URL地址,并且可以保存旧页面的历史记录。php中文网为大家带来了location.assign的相关知识、以及相关文章等内容,供大家免费下载使用。

232

2023.06.27

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1496

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1170

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

835

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

463

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2361

2023.08.08

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

874

2023.08.10

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号