如何通过按键终止PyAutoGUI循环程序？支持中途Esc停止

针对你的需求，最优方案是结合PyAutoGUI原生功能或第三方键盘监听库，同时实现循环次数控制与Esc键中断，还保留故障安全兜底机制，避免程序失控。

方案一：纯PyAutoGUI实现（无需额外依赖） #

利用PyAutoGUI自带的按键检测功能，配合循环次数控制，代码简洁且无需额外安装库：

import pyautogui
import time

# 开启故障安全：鼠标移到屏幕左上角自动终止程序（必备兜底）
pyautogui.FAILSAFE = True
# 设置操作间隔，防止执行过快
pyautogui.PAUSE = 0.5

max_runs = 300
for count in range(max_runs):
    # 实时检测Esc键，按下则跳出循环
    if pyautogui.isPressed('esc'):
        print("Esc键触发，终止循环")
        break
    
    # 替换为你的固定路径点击逻辑
    pyautogui.moveTo(200, 200)  # 示例：移动到目标坐标
    pyautogui.click()           # 执行点击
    
    print(f"已完成第 {count+1}/{max_runs} 次操作")
    # 短延迟降低CPU占用，可根据需求调整
    time.sleep(0.1)

print("程序执行完毕")

方案优势 #

• 零额外依赖，直接用PyAutoGUI原生API实现
• 同时支持300次循环上限和Esc键手动中断
• 故障安全机制作为兜底，即使Esc检测失效，移鼠标到左上角即可紧急终止

方案二：pynput监听（更灵敏的按键检测） #

如果觉得PyAutoGUI的按键检测不够灵敏（比如循环内延迟较长时容易错过按键），可以用pynput库实现全局键盘监听，实时捕获Esc键：

首先安装依赖：

pip install pynput

然后编写代码：

import pyautogui
import time
from pynput.keyboard import Listener, Key

# 开启故障安全机制
pyautogui.FAILSAFE = True
pyautogui.PAUSE = 0.5

max_runs = 300
stop_signal = False

# 定义按键监听回调：捕获Esc键后触发终止信号
def on_key_press(key):
    global stop_signal
    if key == Key.esc:
        stop_signal = True
        print("Esc键已按下，即将终止循环")
        return False  # 停止监听

# 启动监听线程
listener = Listener(on_press=on_key_press)
listener.start()

try:
    for count in range(max_runs):
        if stop_signal:
            break
        
        # 你的鼠标操作逻辑
        pyautogui.moveTo(200, 200)
        pyautogui.click()
        
        print(f"已完成第 {count+1}/{max_runs} 次操作")
        time.sleep(0.1)
finally:
    # 确保监听线程正常停止
    listener.stop()
    listener.join()

print("程序执行完毕")

方案优势 #

• 全局实时监听按键，不会因为循环内的延迟错过Esc键触发
• 线程监听不影响主循环的执行效率，操作流畅度不受影响

注意事项 #

• 无论用哪种方案，都建议保留FAILSAFE = True，这是PyAutoGUI防止程序失控的核心安全机制
• 运行程序时，无需切换到终端，Esc键是全局捕获的，直接按下即可中断循环

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