本文将指导您如何利用Python的`keyboard`库，创建一个全局热键，从而在任何应用程序焦点下，都能立即终止正在运行的Python脚本。通过简单的几行代码，您可以为长时间运行的自动化脚本（如自动点击器）提供一个可靠的紧急停止机制，确保程序在需要时能够迅速停止。
在开发需要长时间运行或在后台执行的Python脚本时，例如自动化工具、游戏辅助脚本或数据监控程序，我们常常需要一个可靠的机制来随时中断程序的执行。传统的停止方式可能需要切换到终端窗口并按下 Ctrl+C，但这在某些场景下并不方便，特别是当脚本在后台运行或当前焦点在其他应用程序时。Python的 keyboard 库提供了一个优雅的解决方案，允许我们创建全局热键，无论当前系统焦点在哪里，都能触发特定的操作，例如终止程序。
准备工作：安装 keyboard 库
在开始之前，您需要确保已安装 keyboard 库。如果尚未安装，可以通过 pip 进行安装：
pip install keyboard
核心实现：创建全局终止热键
keyboard 库的核心功能是监听键盘事件。通过 keyboard.add_hotkey() 函数，我们可以定义一个特定的按键组合，当这个组合被按下时，执行一个预设的回调函数。为了实现程序终止，我们可以将回调函数设置为调用 sys.exit()。
立即学习“Python免费学习笔记（深入）”；
以下是实现这一功能的简洁代码：
import keyboard
import sys
import time # 用于模拟长时间运行的脚本
def exit_program():
"""定义一个函数，用于安全退出程序"""
print("\n热键 's' 已按下，程序即将退出...")
sys.exit()
# 注册全局热键 's'，当按下 's' 键时，调用 exit_program 函数
keyboard.add_hotkey('s', exit_program)
print("程序正在运行中...（按下 's' 键可随时终止）")
print("您可以在任何应用程序中按下 's' 键来测试。")
# 模拟一个长时间运行的脚本
try:
while True:
# 实际的自动化逻辑会在这里运行
# print("脚本正在执行任务...") # 如果频繁打印，可能影响性能
time.sleep(1) # 暂停1秒，模拟工作
except SystemExit:
print("程序已通过热键终止。")
except Exception as e:
print(f"发生异常: {e}")
finally:
# 确保在程序退出前执行清理工作（如果需要）
print("程序清理完成。")
代码解析：
- import keyboard: 导入 keyboard 库，用于处理键盘事件。
- import sys: 导入 sys 模块，其中的 sys.exit() 函数用于终止当前Python程序的执行。
- def exit_program():: 定义一个简单的函数，当热键被触发时，该函数会被调用。它打印一条消息并调用 sys.exit()。
-
keyboard.add_hotkey('s', exit_program): 这是关键一行。它注册了一个全局热键。
- 第一个参数 's' 指定了触发热键的按键（这里是小写字母 's'）。您可以指定更复杂的组合，例如 'ctrl+alt+s' 或 'shift+esc'。
- 第二个参数 exit_program 是当热键被按下时要执行的回调函数。
- while True: 循环: 模拟一个持续运行的脚本。keyboard.add_hotkey() 是非阻塞的，意味着它会在后台监听按键，而不会阻止主程序的执行。
- try...except SystemExit...finally: 这是一个良好的实践，用于捕获 sys.exit() 抛出的 SystemExit 异常，并在程序终止前执行必要的清理工作。
集成到现有脚本
将上述热键逻辑集成到您现有的自动化脚本中非常简单。只需将 import keyboard、import sys 和 keyboard.add_hotkey() 放在脚本的开头部分（通常在所有其他逻辑之前），确保热键监听器在脚本开始执行主要任务之前就已激活。
例如，如果您有一个 pyautogui 的自动点击器脚本：
import keyboard
import sys
import pyautogui
import time
# 定义退出函数
def stop_autoclicker():
print("\n热键 's' 已按下，自动点击器即将停止...")
sys.exit()
# 注册全局热键 's'
keyboard.add_hotkey('s', stop_autoclicker)
print("自动点击器已启动，按下 's' 键可随时停止。")
print("请将鼠标移动到需要点击的位置。")
# 模拟自动点击逻辑
try:
while True:
# 实际的 pyautogui 自动化逻辑
pyautogui.click() # 在当前鼠标位置点击
time.sleep(0.1) # 每0.1秒点击一次
except SystemExit:
print("自动点击器已通过热键终止。")
except Exception as e:
print(f"自动点击器发生异常: {e}")
finally:
print("自动点击器已完全停止。")
热键选择与注意事项
- 选择不冲突的热键：为了避免与操作系统或其他应用程序的快捷键冲突，请谨慎选择热键组合。例如，'ctrl+alt+s' 或 'shift+esc' 可能会是比单独的 's' 更好的选择。
- 全局性：keyboard 库创建的热键是全局的，这意味着无论您的Python脚本是否处于焦点，甚至当您在玩游戏或使用其他软件时，热键都会生效。
- 权限问题：在某些操作系统（特别是Windows）上，监听全局键盘事件可能需要管理员权限。如果您的热键不起作用，尝试以管理员身份运行脚本。
- 程序状态：sys.exit() 会立即终止程序，不执行后续代码。如果需要更“优雅”的退出（例如保存数据、关闭文件句柄等），您可以在 exit_program 函数中添加这些清理逻辑，或者设置一个标志位，让主循环在下次迭代时自行退出。
总结
通过 keyboard 库，为您的Python脚本添加一个全局热键来终止执行是一个强大而实用的功能。它不仅提高了脚本的可用性和用户体验，还提供了一个可靠的紧急停止机制，尤其适用于那些可能长时间运行或在后台执行的自动化任务。通过简单的几行代码，您就可以确保对程序的完全控制，随时随地停止其运行。
