AHK 脚本为什么会误触发：热键穿透、按键连发、修饰键卡住排查

AHK 热键写起来很快，但误触发也很常见：按一次触发多次，明明在一个软件里按键却影响了另一个窗口，Ctrl、Alt、Shift 像卡住一样，或者热键自己触发自己。遇到这些问题，先别急着怀疑 AHK 不稳定，通常是热键作用范围、发送方式、按键释放和重复触发没有处理好。

一、热键穿透：没有限制作用范围

最常见的误触发，是热键在所有窗口都生效。你本来只想在记事本里用 F1，结果游戏、浏览器、聊天窗口里也触发了。

#Requires AutoHotkey v1.1
#NoEnv
#SingleInstance Force
SetTitleMatchMode, 2

#IfWinActive ahk_exe notepad.exe
F1::
MsgBox, 只在记事本里触发
return
#IfWinActive

热键能限制窗口，就尽量限制窗口。全局热键越多，误触发概率越高。

二、按键连发：键盘自动重复和脚本重复

按住一个键不放，系统会自动重复发送按键事件。如果热键没有防抖，就可能触发很多次。

F2::
if (A_PriorHotkey = A_ThisHotkey && A_TimeSincePriorHotkey < 300)
    return
MsgBox, 300ms 内只响应一次
return

这种写法适合防止连续误触。对于真正的开关脚本，也可以用状态变量控制，不要每次按键都重新启动复杂流程。

三、修饰键卡住：发送组合键后没有释放干净

有时脚本发送了 Ctrl、Alt、Shift 组合键，随后系统像一直按着某个修饰键。这可能是脚本中断、目标窗口卡顿、发送方式不合适造成的。

F3::
SendInput, ^c
Sleep, 100
SendInput, {Ctrl up}{Alt up}{Shift up}{LWin up}{RWin up}
return

如果脚本经常模拟复杂组合键，给关键流程加一个“释放修饰键”的收尾动作很有用。遇到卡住时，也可以临时写一个热键专门释放所有修饰键。

四、热键自己触发自己

如果热键里又发送了同一个按键，可能出现递归触发。比如 a::Send, a 就很容易把自己绕进去。可以用 $ 前缀阻止 Send 触发同一个热键。

$a::
SendInput, a
return

$ 的意思是使用键盘钩子，让脚本发送的按键不再触发这个热键本身。写按键替换时尤其要记得。

五、按下和弹起分开处理

有些场景需要分别处理按下和松开，例如长按、临时启用某个模式。只处理按下不处理弹起，就容易状态残留。

~LButton::
isDown := true
return

~LButton Up::
isDown := false
return

~ 表示不拦截原按键，让按键继续传给系统或当前窗口。是否使用它，要看你希望热键“接管按键”还是“旁路监听”。

六、排查清单

• 热键是否应该加 #IfWinActive 限制窗口。
• 是否按住按键导致系统自动重复触发。
• 热键内部是否发送了同一个触发键。
• 是否需要用 $ 防止自触发。
• 是否需要用 KeyWait 等待按键释放。
• 脚本结束前是否释放 Ctrl、Alt、Shift、Win。
• 是否使用了 ~ 导致原按键继续传递。

误触发排查的核心，是弄清楚“谁触发了热键、热键有没有继续把按键传下去、脚本发送的按键会不会再次触发热键”。这三点清楚后，大多数问题都能定位。