如何使用Sublime Text配置AHK脚本实现自动化代码高亮？

本文共计876个文字，预计阅读时间需要4分钟。

安装插件、配置路径、等索引引完成，三步之后 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 FilesAutoHotkey2AutoHotkey.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，然后立刻怀疑插件坏了。其实它正在后台扫符号，等两秒，状态栏提示消失，补全和跳转就活了。