本文详解如何通过结构化逻辑与状态控制，实现 PyAutoGUI 图像查找循环的可靠重启——避免因 break/continue 作用域错误或标志位未重置导致的循环中断问题。
本文详解如何通过结构化逻辑与状态控制，实现 pyautogui 图像查找循环的可靠重启——避免因 `break`/`continue` 作用域错误或标志位未重置导致的循环中断问题。
在使用 PyAutoGUI 构建自动化图像识别流程（如游戏资源采集、UI 自动化操作）时，一个常见痛点是：希望按优先级顺序尝试多个目标图像，任一失败即重试整个序列；完成第一轮后进入第二轮逻辑，并在满足条件时无缝切回第一轮。原始代码中试图用布尔变量 should_restart 控制循环启停，但由于 continue 仅作用于当前 while 循环、break 会彻底退出，且 loop2 = False 后未重置 should_restart = True，导致流程“只跑一次”便终止。
✅ 正确解法：函数封装 + 显式重试逻辑
核心原则是：将“查找-点击”抽象为可复用函数，用 return False 表示失败，用 continue 触发重试，用 break 明确结束当前阶段。以下是优化后的专业实现：
import time
import pyautogui
def find_and_click(image_path, grayscale=False, confidence=0.7):
"""安全查找并点击指定图像，失败返回 False"""
try:
print(f"? 正在查找 {image_path}...")
pos = pyautogui.locateCenterOnScreen(image_path, confidence=confidence, grayscale=grayscale)
if not pos:
print(f"⚠️ 未定位到 {image_path}")
return False
pyautogui.moveTo(pos, duration=0.2)
time.sleep(0.1)
pyautogui.mouseDown()
time.sleep(0.5)
pyautogui.mouseUp()
pyautogui.moveTo(1200, 600, duration=0.2) # 归位防干扰
print(f"✅ 成功点击 {image_path}")
return True
except Exception as e:
print(f"❌ 查找 {image_path} 时异常: {e}")
return False
def run_phase_one():
"""第一阶段：按优先级顺序查找并点击 8 类目标"""
while True:
print("\n? 开始第一阶段循环...")
if not find_and_click("Yellow_FL.png"): continue
if not find_and_click("Green_FL.png", grayscale=True): continue
if not find_and_click("Purple_FL.png", grayscale=True): continue
if not find_and_click("Brown_Battery.png", grayscale=True): continue
if not find_and_click("green_battery.png"): continue
if not find_and_click("Purple_Lens.png", grayscale=True): continue
if not find_and_click("yellow_amp.png"): continue
if not find_and_click("Styptic.png"): continue
print("✅ 第一阶段全部完成，进入第二阶段")
break
def run_phase_two():
"""第二阶段：查找特定 UI 元素，成功后触发回归第一阶段"""
while True:
print("\n? 开始第二阶段循环...")
if not find_and_click("yellow_lens.png"): continue
if not find_and_click("Syringe.png", grayscale=True): continue
if not find_and_click("AutoBloodweb.png", grayscale=True): continue
# 关键逻辑：检测到 "EmptyBloodweb.png" 则终止全流程
try:
if pyautogui.locateOnScreen("EmptyBloo2aaadweb.png", confidence=0.7):
print("? 检测到空血网，任务结束。")
return True # 表示应停止整个主循环
except:
pass
print("✅ 第二阶段完成，准备回归第一阶段...")
return False # 表示应回到 phase one
def main():
"""主控制循环：交替执行两阶段，直至检测到终止条件"""
print("? PyAutoGUI 自动化过滤系统已启动...")
while True:
run_phase_one()
if run_phase_two(): # 若 phase_two 返回 True，说明需终止
break
time.sleep(1) # 阶段间缓冲，防止过快重试
if __name__ == "__main__":
time.sleep(2) # 启动前预留人工切换窗口时间
main()⚠️ 关键注意事项
- 不要依赖全局布尔变量跨循环通信：should_restart = False 在 while loop2: 内修改，对外层 while should_restart: 无影响（作用域隔离）。改用函数返回值传递状态更清晰、更可控。
- continue 的作用范围仅限当前 while 或 for 循环：原始代码中 continue 出现在多层 try/except 内，但它只会跳过当前循环体剩余部分，不会跳出 except 块或影响外层循环。
- 图像查找失败 ≠ 程序异常：pyautogui.locateCenterOnScreen() 找不到时返回 None，而非抛异常；只有 I/O 或 OpenCV 错误才触发 except。因此判断逻辑应优先检查 if not pos:。
-
增加鲁棒性措施：
- 使用 duration 参数让鼠标移动更自然，降低被反作弊系统拦截风险；
- 每次点击后 moveTo(1200, 600) 归位，避免光标偏移干扰后续查找；
- 添加详细日志（print）便于调试和监控运行状态。
✅ 总结
重启循环的本质不是“重置变量”，而是重新进入一个明确的入口点（如函数调用）。通过将业务逻辑拆分为高内聚的函数（run_phase_one / run_phase_two），配合清晰的返回值语义（True = 成功/继续，False = 失败/重试），即可彻底规避嵌套循环中标志位失效、break/continue 误用等经典陷阱。这种结构也易于扩展——例如新增第三阶段、加入超时退出、或接入键盘热键（如 keyboard.is_pressed('q')）实现手动中止。
