sublime text 需装 sublimeautohotkey（作者 evilc）插件、配置正确 build system 路径、等待索引完成三步才能支持 ahk v2；补全和跳转依赖 auto_complete 开启及索引完成，跨文件函数不支持。
Sublime Text 本身不带 AutoHotkey 解释器，也默认不识别 .ahk 文件——装对插件、配准路径、等索引完成，三步缺一不可；其他所有问题，基本都卡在这三步里的某一处。
怎么确认 SublimeAutoHotkey 插件装对了（不是 fincs 旧版）
Package Control 里搜 “AutoHotkey”，同名插件至少有三个。只有 SublimeAutoHotkey（作者 evilC）持续维护、兼容 ST4 + AHK v2。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 等列表加载完，搜SublimeAutoHotkey，只认作者栏写evilC的那一项 - 装完重启 Sublime，新建
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 4CacheSublimeAutoHotkey后重载 - 补全触发词（如
if、loop、send）大小写敏感，输入IF不会弹出，必须小写 - 自定义函数跳转只支持当前文件内定义的函数，跨文件不识别（这是 Sublime 限制，不是插件缺陷）
最容易被忽略的是索引完成前就急着测试跳转，以及误把 v1 和 v2 的 AutoHotkey.exe 路径混用——尤其当两个版本共存时，路径差一个 v2 文件夹，Ctrl+B 就静默失败，连错误提示都不给。
