本文将指导您如何使用 Python 的 `keyboard` 库创建一个全局热键，以便在任何时候通过按下特定按键来立即终止正在运行的 Python 脚本。通过结合 `keyboard.add_hotkey` 和 `sys.exit()`，您可以为自动化任务（如自动点击器）提供一个可靠的紧急停止机制，确保程序能够被迅速、有效地关闭，无论脚本窗口是否处于焦点状态。
在开发自动化脚本，特别是需要长时间运行或涉及模拟用户操作（如自动点击器）的Python程序时，一个常见的需求是能够随时、随地地停止脚本的执行。传统的Ctrl+C方式可能需要控制台窗口处于焦点，这在某些情况下并不方便。此时，创建一个全局热键（Hotkey）便成为一个优雅而高效的解决方案。Python的 keyboard 库提供了一种简洁的方式来实现这一功能。
1. 核心概念与所需库
要实现全局热键终止程序，我们需要用到以下两个Python标准库或第三方库：
- keyboard 库：这是一个用于监听和模拟键盘事件的跨平台库。它允许我们注册一个回调函数，当特定的键或组合键被按下时执行该函数。
- sys 库：Python的 sys 模块提供了对解释器相关功能的访问。其中的 sys.exit() 函数用于终止当前正在执行的Python程序。
2. 安装 keyboard 库
如果尚未安装 keyboard 库，可以通过 pip 命令进行安装：
立即学习“Python免费学习笔记（深入）”；
pip install keyboard
3. 实现全局热键终止程序
以下是实现全局热键以终止Python脚本的基本代码结构：
import keyboard
import sys
import time # 仅用于模拟程序运行，方便测试
def exit_program():
"""定义一个函数，用于安全退出程序"""
print("热键被按下，程序即将退出...")
sys.exit()
# 注册一个全局热键
# 当按下 's' 键时，将调用 exit_program 函数
# 您也可以使用组合键，例如 'ctrl+alt+s'
keyboard.add_hotkey('s', exit_program)
print("程序正在运行中... 按下 's' 键即可终止。")
print("您可以在任何应用中按下 's' 键，程序都会响应。")
# 模拟一个长时间运行的程序
try:
while True:
# 实际的自动化逻辑将在这里运行
# print("程序正在执行任务...")
time.sleep(1)
except SystemExit:
print("程序已通过热键成功退出。")
except Exception as e:
print(f"程序运行中发生错误: {e}")
finally:
# 可以在这里进行一些清理工作
print("程序终止后的清理工作完成。")
代码解析：
- import keyboard 和 import sys：导入所需的库。
- def exit_program(): sys.exit()：我们定义了一个简单的函数 exit_program，它的唯一作用就是调用 sys.exit() 来终止程序。
- keyboard.add_hotkey('s', exit_program)：这是核心语句。它告诉 keyboard 库，当检测到全局范围内按下 's' 键时，就执行 exit_program 函数。
- 第一个参数 's' 是您希望设置的热键。您可以选择任何单个键，也可以是组合键，例如 'ctrl+alt+s'、'shift+esc' 等。
- 第二个参数 exit_program 是一个回调函数，当热键被触发时，它将被执行。
- while True: 循环：这模拟了一个持续运行的程序。在您的实际应用中，这里将是您的自动化逻辑。
- try...except SystemExit...finally 块：
- sys.exit() 实际上会抛出一个 SystemExit 异常。使用 try...except SystemExit 可以捕获这个异常，从而在程序退出前执行一些清理工作或打印最终消息。
- finally 块中的代码无论程序如何退出（正常结束、异常退出或通过 sys.exit() 退出）都会被执行，是进行资源释放、保存状态等操作的理想位置。
4. 更多热键选项
keyboard.add_hotkey() 方法非常灵活，可以接受多种热键组合：
- 单个键：'esc', 'f1', 'space', 'enter'
- 组合键：'ctrl+s', 'alt+f4', 'shift+a', 'ctrl+alt+delete'
- 多键序列：虽然 add_hotkey 主要用于单个热键或组合键，但 keyboard 库也支持更复杂的序列监听（例如，依次按下 'a', 'b', 'c'）。对于简单的终止功能，组合键更为直接。
5. 注意事项
管理员权限：在某些操作系统上，为了捕获系统级的某些热键（尤其是涉及系统功能键的组合），Python脚本可能需要以管理员权限运行。
热键冲突：您设置的热键可能会与操作系统或其他应用程序的现有热键冲突。选择一个不常用的组合键可以降低冲突的可能性。
-
优雅退出：sys.exit() 会立即终止程序，这对于大多数自动化脚本来说是可接受的。但如果您的程序涉及数据库连接、文件写入等需要确保数据完整性的操作，您可能需要实现一个更“优雅”的退出机制。例如，热键触发后不是直接 sys.exit()，而是设置一个全局标志位，让主循环检测到该标志位后自行退出，并在退出前完成必要的清理和保存工作。
# 优雅退出示例 import keyboard import time running = True def stop_program_gracefully(): global running print("热键被按下，程序将在当前任务完成后退出...") running = False keyboard.add_hotkey('s', stop_program_gracefully) print("程序正在运行中... 按下 's' 键即可请求终止。") while running: # 模拟执行一个任务 print("执行任务中...") time.sleep(2) # 假设任务需要2秒 if not running: # 每次任务完成后检查是否需要退出 break print("程序已优雅地退出。") 跨平台兼容性：keyboard 库在 Windows 和 Linux 上表现良好。在 macOS 上，由于系统安全机制，其功能可能会受到一定限制，或者需要额外的权限设置。
总结
使用 keyboard 库结合 sys.exit() 提供了一种简单而强大的方法，为Python自动化脚本添加全局热键终止功能。这极大地提升了脚本的可用性和用户体验，尤其是在需要快速响应和紧急停止的场景中。在实际应用中，根据程序的复杂性和对数据完整性的要求，可以选择直接 sys.exit() 或实现更优雅的退出机制。
