必须安装作者evilC的SublimeAutoHotkey插件，配置硬编码Build System路径指向AHK v1/v2的AutoHotkey.exe，并启用auto_complete、等待索引完成，文件保存为UTF-8 with BOM编码。
装对插件、配准路径、等索引完成，三步缺一不可——否则 Ctrl+B 不执行、if 不补全、Ctrl+Click 跳不到函数，全是这三处卡住。
怎么确认 SublimeAutoHotkey 插件装对了（不是 fincs 旧版）
Package Control 里搜 “AutoHotkey” 会出现至少三个同名插件，只有 SublimeAutoHotkey（作者 evilC）持续维护、兼容 ST4 + AHK v2。其他版本在 Win11 或 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 限制，不是插件缺陷
最容易被忽略的是：文件编码必须为 UTF-8 with BOM，否则中文注释或热键描述可能乱码，且部分 AHK v2 特性（如 Unicode 字符串字面量）会解析失败。保存时务必选 File → Save with Encoding → UTF-8 with BOM。
