必须安装作者evilC的SublimeAutoHotkey插件、硬编码配置指向AHK v1/v2的Build System路径、启用auto_complete并等待索引完成，三步缺一不可；否则将出现高亮失效、补全不弹、跳转失败或“autohotkey not recognized”等错误。
装对插件、配准路径、等索引完成，三步缺一不可。其他所有问题——高亮不生效、补全不弹、跳转失败、报 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相关文件夹），再重装
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 4PackagesUserSublimeAutoHotkey下的缓存目录再重启 - 跳转仅限当前文件内定义的函数，跨文件
Ctrl+Click不生效（这是插件限制，不是配置错） - 脚本必须保存为
UTF-8 with BOM编码，否则中文注释可能触发索引中断
最容易被忽略的是索引完成前就急着试跳转，或者以为装完插件就自动识别所有 .ahk 文件——其实得手动设一次语法，或在 Settings – Syntax Specific 里加 "extensions": ["ahk", "ahk2"]，否则新文件打开还是 Plain Text。
