PyAutoGUI 中 locateAllOnScreen 异常捕获的正确实践
locateAllOnScreen 在未找到图像时会抛出 pyscreeze.ImageNotFoundException，而直接 except ImageNotFoundException: 无法捕获——必须显式导入并指定完整异常路径，否则异常将中断程序。本文详解标准捕获方式、安全遍历策略及实用规避技巧。
pyautogui 中 `locateallonscreen` 在未找到图像时会抛出 `pyscreeze.imagenotfoundexception`，而直接 `except imagenotfoundexception:` 无法捕获——必须显式导入并指定完整异常路径，否则异常将中断程序。本文详解标准捕获方式、安全遍历策略及实用规避技巧。
在使用 PyAutoGUI 进行图像定位自动化（如游戏辅助、UI 测试）时，locateCenterOnScreen 和 locateAllOnScreen 是两个核心函数：前者仅返回首个匹配中心点，后者返回所有匹配区域的 (left, top, width, height) 元组迭代器。但关键区别在于——locateAllOnScreen 不支持“静默失败”，它在无匹配时必然抛出异常；而 locateCenterOnScreen 虽也抛异常，但因返回单值，常被 try/except 包裹得更自然。
你遇到的报错：
pyscreeze.ImageNotFoundException: Could not locate the image (highest confidence = 0.550)
说明 locateAllOnScreen 内部调用 OpenCV 模板匹配后，最高置信度（0.550）未达 confidence=0.6 阈值，于是主动抛出 pyscreeze.ImageNotFoundException。此时若未正确捕获该异常，线程将崩溃（如你所见的 Exception in thread Thread-1）。
✅ 正确捕获方式（关键！）
ImageNotFoundException 并非 PyAutoGUI 直接导出的异常，而是来自其底层依赖库 pyscreeze。因此，必须显式导入 pyscreeze.ImageNotFoundException，或使用全限定名捕获：
import pyscreeze
from pyautogui import locateAllOnScreen
# ✅ 推荐：显式导入 + 精准捕获
try:
locs = locateAllOnScreen('Gem.png', confidence=0.6)
except pyscreeze.ImageNotFoundException:
locs = [] # 赋空列表，确保后续 for 循环安全执行
for pos in locs:
x = pos[0] + pos[2] // 2
y = pos[1] + pos[3] // 2
# ... 后续操作
⚠️ 常见错误写法（导致捕获失效）：
# ❌ 错误1：未导入 pyscreeze，直接 except ImageNotFoundException except ImageNotFoundException: # NameError: name 'ImageNotFoundException' is not defined # ❌ 错误2：导入了但未用全限定名（pyautogui 不重导此异常） from pyautogui import * except ImageNotFoundException: # 仍无法匹配
? 进阶建议：避免重复扫描的轻量级优化
虽然 locateAllOnScreen 本身不提供“零匹配时返回空迭代器”的选项，但可借助 locateCenterOnScreen 快速预检，再决定是否调用全量搜索（正如你在 Edit 中发现的方案）。这不仅规避异常，还能提升性能（尤其在高分辨率屏幕或低匹配率场景）：
def safe_locate_all(image_path, confidence=0.7):
"""安全获取所有匹配位置，无匹配时返回空列表"""
try:
# 快速预检：是否存在至少一个匹配？
if locateCenterOnScreen(image_path, confidence=confidence) is None:
return []
except pyscreeze.ImageNotFoundException:
return []
# 存在匹配 → 执行全量搜索
try:
return list(locateAllOnScreen(image_path, confidence=confidence))
except pyscreeze.ImageNotFoundException:
return []
# 使用示例
locs = safe_locate_all('Gem.png', confidence=0.6)
for pos in locs:
x, y = pos[0] + pos[2]//2, pos[1] + pos[3]//2
moveTo(x + 768, y)
mouse.click(Button.left, 1)
? 注意事项总结：
- 始终检查 pyscreeze 版本兼容性：PyAutoGUI ≥ 0.9.50 默认依赖 pyscreeze >= 0.1.27，异常类定义稳定；
- confidence 参数需合理设置：过低（如 0.9）对轻微缩放/抗锯齿敏感。建议从 0.7~0.8 起调；
- 线程安全提醒：你的多线程结构（threading.Thread + pynput.Listener）是合理的，但确保 locateAllOnScreen 调用期间屏幕未被其他窗口遮挡（可加 grayscale=True 提升鲁棒性）；
- 替代方案考虑：若图像动态变化大（如 UI 动画、粒子特效），建议结合 OCR（pytesseract）或自定义 CV 流程（cv2.matchTemplate + 非极大值抑制），而非纯模板匹配。
通过精准异常捕获与预检逻辑组合，你既能获得全部目标坐标，又能保障脚本长期稳定运行——这才是工业级自动化脚本的健壮基石。