使用Python keyboard 库创建全局热键，实现程序优雅退出-Python教程-PHP中文网

使用Python keyboard 库创建全局热键，实现程序优雅退出

心靈之曲

发布： 2025-11-26 12:33:17

原创

817人浏览过

使用python keyboard 库创建全局热键，实现程序优雅退出

本文将指导您如何利用Python的`keyboard`库，创建一个全局热键，从而在任何应用程序焦点下，都能立即终止正在运行的Python脚本。通过简单的几行代码，您可以为长时间运行的自动化脚本（如自动点击器）提供一个可靠的紧急停止机制，确保程序在需要时能够迅速停止。

在开发需要长时间运行或在后台执行的Python脚本时，例如自动化工具、游戏辅助脚本或数据监控程序，我们常常需要一个可靠的机制来随时中断程序的执行。传统的停止方式可能需要切换到终端窗口并按下 Ctrl+C，但这在某些场景下并不方便，特别是当脚本在后台运行或当前焦点在其他应用程序时。Python的 keyboard 库提供了一个优雅的解决方案，允许我们创建全局热键，无论当前系统焦点在哪里，都能触发特定的操作，例如终止程序。

准备工作：安装 keyboard 库

在开始之前，您需要确保已安装 keyboard 库。如果尚未安装，可以通过 pip 进行安装：

pip install keyboard

登录后复制

核心实现：创建全局终止热键

keyboard 库的核心功能是监听键盘事件。通过 keyboard.add_hotkey() 函数，我们可以定义一个特定的按键组合，当这个组合被按下时，执行一个预设的回调函数。为了实现程序终止，我们可以将回调函数设置为调用 sys.exit()。

立即学习“Python免费学习笔记（深入）”；

以下是实现这一功能的简洁代码：

火山写作

字节跳动推出的中英文AI写作、语法纠错、智能润色工具，是一款集成创作、润色、纠错、改写、翻译等能力的中英文 AI 写作助手。

167

查看详情

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 函数中添加这些清理逻辑，或者设置一个标志位，让主循环在下次迭代时自行退出。