ctypes中GetAsyncKeyState函数结果异常问题求助

原代码 #

import ctypes

def mouse_released() -> bool:
    mouse_state = ctypes.windll.user32.GetAsyncKeyState(0x01)
    if mouse_state:
        while ctypes.windll.user32.GetAsyncKeyState(0x01):
            continue  # is pressing
        else:
            print('released')
            return mouse_state != 0 # released
    return False

while True:
    mouse_released()

问题描述 #

本程序用于检测鼠标左键是否被释放，存在两个异常：

1. 启动初期，明明几秒内未按下鼠标，却会打印“released”；
2. 替换GetAsyncKeyState为GetKeyState后，误判问题解决，但函数仅能每隔一次检测到按键按下。

原因分析 #

1. GetAsyncKeyState启动误判的原因 #

GetAsyncKeyState返回一个16位整数：

• 最高位（第15位）：标记自上次调用该函数以来，按键是否被按下过；
• 最低位（第0位）：标记当前时刻按键是否处于按下状态。

程序启动时，若之前（哪怕是启动前）鼠标左键有过按下操作，第一次调用GetAsyncKeyState时最高位会被置1，导致mouse_state非0，进入后续逻辑。此时按键实际未按下，循环直接退出，触发“released”打印。

2. GetKeyState检测异常的原因 #

GetKeyState返回的是调用线程消息队列中按键的状态，它依赖Windows消息循环更新状态。你的程序没有消息循环，且GetKeyState的状态仅在处理键盘/鼠标消息后更新，因此会出现每隔一次才能检测到按键的情况——第一次调用时状态未同步，第二次才反映实际状态。

解决方案 #

通过记录按键的历史状态，结合GetAsyncKeyState的最低位判断当前状态，准确检测释放事件：

阻塞式检测版本 #

import ctypes
import time

def mouse_released():
    prev_state = False
    while True:
        # 仅取最低位，判断当前按键是否按下
        current_state = ctypes.windll.user32.GetAsyncKeyState(0x01) & 0x01
        # 上一次按下、当前未按下，判定为释放
        if prev_state and not current_state:
            print('released')
            return True
        prev_state = current_state
        # 降低CPU占用
        time.sleep(0.01)

while True:
    mouse_released()

非阻塞式检测版本 #

import ctypes
import time

prev_mouse_state = False

def check_mouse_released() -> bool:
    global prev_mouse_state
    current_state = ctypes.windll.user32.GetAsyncKeyState(0x01) & 0x01
    released = False
    if prev_mouse_state and not current_state:
        print('released')
        released = True
    prev_mouse_state = current_state
    return released

while True:
    check_mouse_released()
    time.sleep(0.01)

修改说明 #

• 仅提取GetAsyncKeyState返回值的最低位，避免历史按键记录导致的启动误判；
• 通过对比前后状态，确保只有“按下→释放”的转换才会触发事件，逻辑更精准；
• 添加time.sleep(0.01)，避免程序空跑占用过高CPU资源。

内容的提问来源于stack exchange，提问作者Владислав