如何在Windows系统中拦截按键输入且仅被自身程序捕获？

核心需求说明 #

要实现全局拦截按键输入且阻止其他应用捕获，本质是设置系统级的键盘钩子，并在钩子中终止事件传递流程。以下提供两种Python实现方案：

方案一：使用pynput快速实现 #

pynput是封装好的跨平台输入监听库，Windows下通过系统钩子实现全局监听，只需设置suppress=True即可阻止事件传递给其他应用。

代码示例 #

from pynput import keyboard

def on_press(key):
    # 处理按键按下事件
    try:
        print(f"按下普通按键: {key.char}")
    except AttributeError:
        print(f"按下特殊按键: {key}")

def on_release(key):
    # 处理按键释放事件
    print(f"释放按键: {key}")
    if key == keyboard.Key.esc:
        # 按下ESC键停止监听
        return False

# 启动监听器，suppress=True拦截事件不传递给其他应用
with keyboard.Listener(
        on_press=on_press,
        on_release=on_release,
        suppress=True
) as listener:
    listener.join()

优缺点 #

• 优势：代码简洁、易维护，跨平台支持（Linux/macOS也能使用）。
• 局限：灵活性稍弱，无法直接操作底层Windows API。

方案二：使用pywin32直接调用Windows API #

通过Windows原生的低级键盘钩子（WH_KEYBOARD_LL）实现全局拦截，该钩子无需注入其他进程，安全性较高，且能精细控制事件传递。

代码示例 #

import win32api
import win32con
import win32gui

def keyboard_hook(nCode, wParam, lParam):
    if nCode >= 0:
        key_code = lParam[0]
        # 判断是按下还是释放事件
        is_pressed = (wParam == win32con.WM_KEYDOWN) or (wParam == win32con.WM_SYSKEYDOWN)
        
        if is_pressed:
            print(f"按键 {key_code} 被按下")
            # 返回1阻止事件传递给其他应用，返回0则允许
            return 1
    
    # 调用下一个钩子（必须执行，否则系统会报错）
    return win32api.CallNextHookEx(hook_id, nCode, wParam, lParam)

# 注册全局键盘钩子
hook_id = win32api.SetWindowsHookEx(
    win32con.WH_KEYBOARD_LL,
    keyboard_hook,
    win32api.GetModuleHandle(None),
    0
)

# 启动消息循环，保持钩子运行
try:
    msg = win32gui.GetMessage(None, 0, 0)
    while msg:
        win32gui.TranslateMessage(msg)
        win32gui.DispatchMessage(msg)
        msg = win32gui.GetMessage(None, 0, 0)
finally:
    # 程序退出时卸载钩子
    win32api.UnhookWindowsHookEx(hook_id)

优缺点 #

• 优势：完全掌控底层逻辑，可实现复杂的按键处理逻辑。
• 局限：仅支持Windows平台，代码相对繁琐。

关键注意事项 #

1. 管理员权限：全局钩子需要以管理员身份运行脚本，否则可能无法生效。
2. 退出机制：测试时务必设置退出按键（如示例中的ESC），避免键盘被锁死无法操作。
3. 钩子性能：钩子处理函数需尽量简洁，若执行耗时过长，系统会自动卸载钩子。
4. 系统按键限制：部分系统级按键（如Ctrl+Alt+Del）无法被拦截，这类按键由系统直接处理，不受用户态钩子影响。

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