如何检测并恢复Autohotkey中跨VM的Esc按键状态不匹配异常？

问题场景与复现步骤 #

异常触发脚本（Esc1.ahk） #

~Esc & 1:: Esc1()
Esc1()
{
    static s_count := 0
    s_count++
    tooltip, % "Esc1 #" s_count
}

异常触发操作流程 #

• 激活主机文本编辑器（如EmEditor）后按下Esc键
• 点击切换到VMware虚拟机窗口
• 在虚拟机内释放Esc键
• 切回主机文本编辑器
• 多次按下1键

异常表现 #

• 提示框连续触发（显示Esc1 #2、Esc1 #3等）
• 1键无法输入到文本编辑器

核心原因：主机端AutoHotkey未捕获到Esc的KEYUP事件，仍判定Esc处于按下状态，需在非VM窗口重新按一次Esc才能恢复。

检测与恢复方案 #

1. 检测物理按键真实状态 #

AutoHotkey自带的GetKeyState("Esc", "P")无法识别这种跨窗口的按键状态异常，需调用Windows原生API获取真实物理按键状态，通过DllCall实现：

; 获取指定按键的真实物理状态，返回0表示未按下，1表示按下
GetRealKeyState(Key) {
    VK := GetKeyVK(Key)
    return DllCall("user32.dll\GetAsyncKeyState", "Int", VK, "Short") & 0x8000 ? 1 : 0
}

2. 自动定时检测并修复异常 #

通过定时任务检查按键状态，当AutoHotkey内部记录与真实物理状态不符时，强制发送KEYUP事件修复：

#Persistent
SetTimer, CheckEscState, 500 ; 每500毫秒检查一次

CheckEscState() {
    ahkState := GetKeyState("Esc", "P") ; AHK内部记录的按键状态
    realState := GetRealKeyState("Esc") ; 真实物理按键状态
    
    ; 当AHK认为按下但实际已释放时，执行修复
    if (ahkState = 1 && realState = 0) {
        Send {Esc Up}
        Tooltip, 已修复Esc按键状态异常
        SetTimer, HideTooltip, -1500 ; 1.5秒后隐藏提示
    }
}

GetRealKeyState(Key) {
    VK := GetKeyVK(Key)
    return DllCall("user32.dll\GetAsyncKeyState", "Int", VK, "Short") & 0x8000 ? 1 : 0
}

HideTooltip() {
    Tooltip
}

3. 组合键逻辑内直接校验优化 #

在组合键触发逻辑中加入真实状态校验，避免异常触发的同时自动修复：

~Esc & 1::
    ; 仅当Esc真实按下时执行原逻辑
    if (GetRealKeyState("Esc")) {
        Esc1()
    } else {
        ; 状态异常时先修复，再发送1键输入
        Send {Esc Up}
        Send 1
    }
return

Esc1() {
    static s_count := 0
    s_count++
    tooltip, % "Esc1 #" s_count
    SetTimer, HideTooltip, -2000
}

GetRealKeyState(Key) {
    VK := GetKeyVK(Key)
    return DllCall("user32.dll\GetAsyncKeyState", "Int", VK, "Short") & 0x8000 ? 1 : 0
}

HideTooltip() {
    Tooltip
}

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