必须安装作者为evilc的sublimeautohotkey插件，配置硬编码build system指向ahk v2/v1对应路径，并启用auto_complete且等待索引完成，三步缺一不可。
装对插件、配准路径、等索引完成，三步之后 Ctrl+B 才真能跑起来。其他所有问题——高亮不生效、补全不弹、跳转失败、报 autohotkey not recognized——基本都卡在这三步里的某一处。
怎么确认 SublimeAutoHotkey 插件装对了（不是 fincs 旧版）
别搜“AutoHotkey”就点安装。Package Control 里同名插件至少有三个，只有 SublimeAutoHotkey（作者 evilC）持续维护、兼容 ST4 + AHK v2。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 等列表加载完，搜SublimeAutoHotkey，只认作者栏写evilC的那一项 - 装完新建
test.ahk，右下角状态栏必须显示AutoHotkey；若仍是Plain Text，说明没生效 - 失效时先删掉
%APPDATA%Sublime Text 4PackagesUser下残留的旧插件配置（比如AutoHotkey或sublime-ahk相关文件夹），再重装 - AHK v1 用户可勉强用，但函数跳转、
loop/if补全对 v2 支持更完整；v2 默认安装路径是C:Program FilesAutoHotkey 2AutoHotkey.exe，别和 v1 的C:Program FilesAutoHotkeyAutoHotkey.exe混了
Build System 怎么写才不报 “autohotkey not recognized”
这个错误不是 Sublime 的锅，是它根本找不到 AutoHotkey.exe。PATH 方案容易漏加或未重启生效，硬编码路径最稳。
- 菜单 →
Tools→Build System→New Build System… - 粘贴以下内容（注意双反斜杠
\，单斜杠会解析失败）：
{ "cmd": ["C:\Program Files\AutoHotkey\v2\AutoHotkey.exe","$file"], "shell": true, "working_dir":"$file_path", "file_regex":"^([^
]+)((d+)):? ?(.*)$", "selector":"source.ahk" }
- 保存为
AutoHotkey.sublime-build（扩展名必须是.sublime-build） - 之后打开任意
.ahk文件，在右下角Build System菜单里手动选它，Ctrl+B才真正调用本地解释器 - 用 AHK v1 的话，把路径改成
C:\Program Files\AutoHotkey\AutoHotkey.exe，别漏掉v2文件夹层级
为什么 if / loop 补全不弹、Ctrl+Click 跳不到函数
补全和跳转不是“装完就开”，有两个隐藏开关必须打开，且首次索引需要几秒等待。
- 确认全局补全已启用：菜单 →
Preferences→Settings，左侧默认设置中搜auto_complete，确保值为true - 函数跳转依赖插件后台索引，首次使用需等右下角状态栏出现
Indexing…提示消失；若一直转圈，删掉%APPDATA%Sublime Text 4CacheSublimeAutoHotkey后重启 Sublime - 补全触发词如
if、loop、send是大小写敏感的，输入IF不会弹出，必须小写if - 跳转仅限当前文件内定义的函数，跨文件函数不会识别
最容易被忽略的是索引等待时间——你改完设置、重启 Sublime、新建文件、敲 if，然后立刻怀疑插件坏了。其实它正在后台扫符号，等两秒，状态栏提示消失，补全和跳转就活了。
