Python开发：如何避免Windows注册热键占用常规键盘输入？

我用Python开发工具时添加了热键控制功能，热键的注册、释放与使用都正常，但存在一个问题：当设置单个键盘按键为热键时，该按键的常规输入功能会被禁用——即使关闭热键开关，也必须注销该键才能恢复正常输入。

核心代码 #

class HotkeyListener(threading.Thread):
    def __init__(self, root):
        threading.Thread.__init__(self)
        self.root = root
        self.user32 = ctypes.windll.user32
        self.hkey_dict = {}  # alt-->0x0001,ctrl-->0x0002,shift-->0x0004,win-->0x0008
        self.hkey_queue = Queue()

    def run(self):
        try:
            while True:
                if not self.hkey_queue.empty():
                    hkey = self.hkey_queue.get()
                    hkey()
                msg = ctypes.wintypes.MSG()

                """Process the message received when the hotkey is turned off --> remove it directly, 
                otherwise it will accumulate until the hotkey is turned on and continue to execute
                """
                if not Global.hotkey_use:  
                    self.user32.PeekMessageW(ctypes.byref(msg), None, 0, 0, win32con.PM_REMOVE)
                if self.user32.PeekMessageA(ctypes.byref(msg), None, 0, 0, win32con.PM_REMOVE):
                    if msg.message == win32con.WM_HOTKEY:  # Whether hotkey message
                        if msg.wParam in self.hkey_dict:   # Is id in the dictionary
                            flag()
                            # Execute hotkey function
                            self.root.after(0, self.hkey_dict[msg.wParam]["func"])

                self.user32.TranslateMessage(ctypes.byref(msg))
                self.user32.DispatchMessageA(ctypes.byref(msg))
                time.sleep(0.01)  # Reduce CPU usage

        finally:
            for ID in self.hkey_dict:
                self.user32.UnregisterHotKey(None, ID)

目前Global.hotkey_use只能阻止热键触发，但无法恢复按键的常规输入功能。曾尝试调整Global.hotkey_use的判断位置，如下代码，但仍未解决问题：

while True:
    if not self.hkey_queue.empty():
        hkey = self.hkey_queue.get()
        hkey()
    msg = ctypes.wintypes.MSG()

    if self.user32.PeekMessageA(ctypes.byref(msg), None, 0, 0, win32con.PM_REMOVE):
        if msg.message == win32con.WM_HOTKEY:
            if msg.wParam in self.hkey_dict:
                if Global.hotkey_use:
                    flag()
                    self.root.after(0, self.hkey_dict[msg.wParam]["func"])

解决方案 #

问题本质 #

Windows的RegisterHotKey API有个特性：一旦热键注册成功，系统会拦截对应按键的常规输入消息，转而发送WM_HOTKEY消息。只要热键处于注册状态，不管你是否处理WM_HOTKEY消息，该按键的常规输入都会被阻断——这就是你调整开关逻辑无效的核心原因。

方案一：封装注册/注销逻辑（推荐） #

所谓“不够优雅”其实是误解，这种方式完全符合Windows API的工作机制，且性能开销极小。可以封装一个开关方法，在关闭热键时保存配置并注销，开启时快速重注册：

def toggle_hotkeys(self, enable):
    Global.hotkey_use = enable
    if not enable:
        # 保存当前热键配置，注销所有热键
        self.saved_config = list(self.hkey_dict.values())
        for hotkey_id in self.hkey_dict:
            self.user32.UnregisterHotKey(None, hotkey_id)
        self.hkey_dict.clear()
    else:
        # 重新注册所有热键
        for config in self.saved_config:
            # 假设config包含注册所需的modifiers、key_code、func、id参数
            self.user32.RegisterHotKey(None, config["id"], config["modifiers"], config["key_code"])
            self.hkey_dict[config["id"]] = config

方案二：改用低级键盘钩子 #

放弃RegisterHotKey，改用SetWindowsHookEx设置全局键盘钩子，自己控制消息传递逻辑，无需反复注册/注销热键：

import ctypes
import win32con
from ctypes import wintypes

user32 = ctypes.windll.user32
kernel32 = ctypes.windll.kernel32

# 定义钩子回调函数类型
HOOKPROC = ctypes.CFUNCTYPE(wintypes.LRESULT, wintypes.int, wintypes.WPARAM, wintypes.LPARAM)

class KeyboardHook:
    def __init__(self, root):
        self.root = root
        self.hook_id = None
        self.hotkey_config = {}  # 存储热键配置：{按键码: 回调函数}
        self.hotkey_use = False

    def hook_callback(self, nCode, wParam, lParam):
        if nCode >= 0 and self.hotkey_use:
            kb_data = ctypes.cast(lParam, ctypes.POINTER(wintypes.KBDLLHOOKSTRUCT)).contents
            key_code = kb_data.vkCode
            # 检测目标热键（以单个按键为例）
            if key_code in self.hotkey_config and wParam == win32con.WM_KEYDOWN:
                # 执行热键回调
                self.root.after(0, self.hotkey_config[key_code])
                return 1  # 阻止消息传递，禁用常规输入
        # 继续传递消息，保留常规输入
        return user32.CallNextHookEx(self.hook_id, nCode, wParam, lParam)

    def start(self):
        # 设置全局键盘钩子
        self.hook_proc = HOOKPROC(self.hook_callback)
        self.hook_id = user32.SetWindowsHookExW(win32con.WH_KEYBOARD_LL, self.hook_proc, kernel32.GetModuleHandleW(None), 0)

    def stop(self):
        if self.hook_id:
            user32.UnhookWindowsHookEx(self.hook_id)
            self.hook_id = None

内容的提问来源于stack exchange，提问作者郑瑜晨