本教程详细介绍了如何利用python的`keyboard`库创建全局热键，以便在任何时候通过键盘快捷键优雅地终止正在运行的python脚本，即使脚本在后台运行或执行长时间任务。文章提供了具体的代码示例，并探讨了将其集成到现有程序中的方法，确保脚本控制的灵活性和便捷性。
在开发自动化脚本（如自动点击器、数据抓取工具）或任何长时间运行的Python程序时，我们经常需要一种机制来在任何时候、任何应用程序界面下都能停止脚本的执行。传统的停止方式可能需要切换到终端并手动终止进程，这既不方便也不够优雅。Python的keyboard库提供了一个强大的解决方案，允许我们注册全局热键，一旦按下即可触发特定操作，例如安全地退出脚本。
要实现通过热键终止Python脚本，我们需要keyboard库来监听键盘事件，并使用sys库来执行程序退出操作。
首先，确保你已经安装了keyboard库：
pip install keyboard
接下来，以下是实现热键终止脚本的核心代码：
import keyboard
import sys
# 注册一个全局热键：当按下 's' 键时，执行 sys.exit() 退出程序
keyboard.add_hotkey('s', lambda: sys.exit()) 这段代码的核心在于keyboard.add_hotkey()函数：
上述代码片段本身只会注册热键，如果程序没有其他任务，它可能会立即退出。在实际应用中，例如一个自动点击器，你的脚本会有一个主循环来执行其核心功能。你需要将add_hotkey的调用放在主循环开始之前，这样脚本在执行其任务的同时，也能持续监听热键。
以下是一个模拟长时间运行任务的完整示例，展示了如何集成热键：
import keyboard import sys import time import threading # 定义一个标志，用于控制主循环的运行 running = True def exit_program(): """热键触发的回调函数，用于安全退出程序""" global running print("\n热键 's' 被按下，正在准备退出程序...") running = False # 如果有其他资源需要清理，可以在这里添加 # sys.exit() # 也可以直接在这里调用 sys.exit()，但使用标志更优雅 # 注册热键：当按下 's' 键时，调用 exit_program 函数 # 注意：keyboard库在内部会启动一个线程来监听按键事件，所以不会阻塞主程序 keyboard.add_hotkey('s', exit_program) print("程序已启动，正在执行模拟任务...") print("你可以随时按下 's' 键来终止程序。") try: # 模拟一个长时间运行的主程序循环 counter = 0 while running: print(f"程序正在运行，执行任务... 计数: {counter}") counter += 1 time.sleep(2) # 模拟任务耗时 if counter > 100: # 设置一个自动停止的条件，防止无限循环 print("模拟任务完成，程序即将退出。") running = False except KeyboardInterrupt: print("程序被用户通过 Ctrl+C 中断。") except Exception as e: print(f"程序发生异常: {e}") finally: # 确保在程序退出前移除热键监听，释放资源 # 这不是强制的，但对于长时间运行的程序来说是良好的实践 keyboard.remove_hotkey('s') print("程序已安全退出。")
在这个示例中：
通过keyboard库，我们可以轻松地为Python脚本添加全局热键功能，极大地提升了脚本的可控性和用户体验。无论是需要紧急停止一个自动化任务，还是希望在后台运行的程序中触发特定操作，keyboard.add_hotkey()都提供了一个简洁而强大的解决方案。正确地集成和使用这一功能，将使你的Python程序更加健壮和易于管理。
t_program():
"""热键触发的回调函数，用于安全退出程序"""
global running
print("\n热键 's' 被按下，正在准备退出程序...")
running = False
# 如果有其他资源需要清理，可以在这里添加
# sys.exit() # 也可以直接在这里调用 sys.exit()，但使用标志更优雅
# 注册热键：当按下 's' 键时，调用 exit_program 函数
# 注意：keyboard库在内部会启动一个线程来监听按键事件，所以不会阻塞主程序
keyboard.add_hotkey('s', exit_program)
print("程序已启动，正在执行模拟任务...")
print("你可以随时按下 's' 键来终止程序。")
try:
# 模拟一个长时间运行的主程序循环
counter = 0
while running:
print(f"程序正在运行，执行任务... 计数: {counter}")
counter += 1
time.sleep(2) # 模拟任务耗时
if counter > 100: # 设置一个自动停止的条件，防止无限循环
print("模拟任务完成，程序即将退出。")
running = False
except KeyboardInterrupt:
print("程序被用户通过 Ctrl+C 中断。")
except Exception as e:
print(f"程序发生异常: {e}")
finally:
# 确保在程序退出前移除热键监听，释放资源
# 这不是强制的，但对于长时间运行的程序来说是良好的实践
keyboard.remove_hotkey('s')
print("程序已安全退出。")