必须安装 sublimeautohotkey（作者 evilc）插件，而非 fincs 的旧版；配置正确构建系统指向 ahk v2/v1 可执行文件；文件编码需为 utf-8 with bom；函数跳转仅限当前文件内定义的函数。
Sublime Text 本身不支持 AutoHotkey（AHK），必须靠插件补全语法识别、构建运行、跳转补全等能力——不装对插件，.ahk 文件永远是 Plain Text，if 和 return 全灰，Ctrl+B 直接报错。
该装哪个插件？别选错作者和版本
必须安装 SublimeAutoHotkey（作者 evilC），不是 fincs 的旧版 AutoHotkey 插件。后者已多年未更新，Win11 + AHK v2 下语法解析错漏多，函数跳转失效，甚至导致 Sublime 启动卡顿。
- 用
Ctrl+Shift+P调出命令面板 → 输入Install Package→ 等列表加载完，搜SublimeAutoHotkey，认准作者是evilC - 装完重启 Sublime，新建
test.ahk，右下角状态栏应显示AutoHotkey；若仍为Plain Text，右键标签页 →Set Syntax → AutoHotkey - 想让所有
.ahk和.ahk2文件自动识别：打开Preferences → Settings – Syntax Specific，填入：{ "extensions": ["ahk", "ahk2"] }
构建系统怎么配？路径、反斜杠、v1/v2 别混
Sublime 不带解释器，Ctrl+B 能否运行，取决于你写的 .sublime-build 是否指向正确的 AutoHotkey.exe。常见错误是路径写错、反斜杠没双写、v1/v2 混用。
- 确认 AHK 安装路径：v2 默认在
C:Program FilesAutoHotkey 2AutoHotkey.exe；v1 是C:Program FilesAutoHotkeyAutoHotkey.exe - 新建构建系统：
Tools → Build System → New Build System…，粘贴以下内容（注意双反斜杠）：{ "cmd": ["C:\Program Files\AutoHotkey\v2\AutoHotkey.exe", "$file"], "shell": true, "working_dir": "$file_path" } - 保存为
AutoHotkey.sublime-build，之后在右下角Build System菜单中手动选它 - 如果提示
'autohotkey' is not recognized，说明没加进 PATH；或直接在构建系统里写死绝对路径，更稳妥
Ctrl+Click 跳转函数为啥无效？索引和作用域限制
函数跳转依赖插件后台建立的符号索引，不是实时生效的，而且只支持当前文件内定义的函数——跨文件、库函数、#Include 进来的都不行，这是 Sublime 自身限制，不是插件缺陷。
- 首次启用跳转后，等几秒看状态栏是否显示 “Indexing…”；若一直转圈，删掉
%APPDATA%Sublime Text 4CacheSublimeAutoHotkey后重启 - 自定义函数必须写在当前
.ahk文件里，且不能用Func("name")动态调用形式，否则无法被索引到 - 补全（Tab）只对内置函数和当前文件定义的函数有效；
Gui、Menu等关键字补全需插件完整加载后才稳定
中文乱码、热文本失效、运行无反应？检查这三处
脚本明明写对了，却弹不出 MsgBox、热文本不触发、中文显示方块——问题往往不在代码，而在编码、执行权限或构建配置。
- 文件编码必须是 UTF-8 with BOM（尤其含中文字符串时），用
File → Save with Encoding → UTF-8 with BOM - 若用
Run启动外部程序失败，检查路径中是否有空格或中文；建议用双引号包裹路径：Run, "C:My Toolspp.exe" -
Ctrl+B没反应？确认右下角Build System已选中你刚建的AutoHotkey，不是Automatic或其他 - 热键（如
^s::）在 Sublime 内部可能被编辑器快捷键拦截，测试时先切到记事本再按
最易忽略的是：插件只管编辑体验，不改 AHK 本身的语法逻辑；MsgBox 在 v2 中参数顺序和 v1 不同，return 在函数末尾非强制，这些错误不会被高亮，但会导致运行失败。写完务必用 Ctrl+B 实时验证，别只盯着颜色对不对。
