必须安装作者evilc的sublimeautohotkey插件，配置语法识别（添加"extensions": ["ahk","ahk2"]）、构建系统（指定ahk v2/v1绝对路径并双写反斜杠）、开启auto_complete及等待索引完成，三者缺一不可。
Sublime Text 不能直接运行 AutoHotkey 脚本，也默认不识别 .ahk 文件——所谓“配置环境”，本质是三件事：让文件有语法高亮、让 Ctrl+B 能调起 AutoHotkey.exe、让补全和跳转不掉链子。缺一不可，但每一步都容易卡在细节上。
怎么装对插件？认准 SublimeAutoHotkey（作者 evilC）
别搜“AutoHotkey”就点安装。fincs 维护的老版插件已多年未更新，在 Win11 + AHK v2 下解析错漏多，函数跳转失效，甚至拖慢 Sublime 启动。必须用 SublimeAutoHotkey（作者名是 evilC）。
操作路径：
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 回车 - 等列表加载完，输入
SublimeAutoHotkey，只选作者为evilC的那一项 - 安装完重启 Sublime，新建
test.ahk，右下角状态栏应显示AutoHotkey；若仍为Plain Text，右键标签页 →Set Syntax → AutoHotkey
为什么 Ctrl+B 按了没反应？构建系统路径写法最易错
Ctrl+B 失败，90% 是构建系统没指向真实 AutoHotkey.exe。Sublime 不查 PATH，也不猜路径，它只认你写的绝对路径。
常见错误现象：
- 提示
'autohotkey' is not recognized：说明没加 PATH，或构建系统里没写死路径 - 报错
The system cannot find the file specified：路径含空格但没加引号，或反斜杠只写了一个 - 脚本运行但当前目录不对，
FileRead找不到同级文件：没设working_dir
正确做法（以 AHK v2 为例）：
{
"cmd": ["C:\Program Files\AutoHotkey\v2\AutoHotkey.exe", "$file"],
"selector": "source.ahk",
"working_dir": "$file_path",
"shell": true
}
注意：\ 必须双写；$file 是完整路径，$file_path 是所在目录；v1 和 v2 的 AutoHotkey.exe 路径不同，别混。
补全和 Ctrl+Click 跳转为啥不工作？两个隐藏开关要开
装了插件 ≠ 补全自动生效。SublimeAutoHotkey 的补全依赖两个前提：
-
"auto_complete": true必须在全局设置里开启（Preferences → Settings，左侧搜该字段确认为true） - 函数跳转需要插件完成符号索引，首次使用会延迟几秒；如果一直转圈，删掉
%APPDATA%\Sublime Text 4\Cache\SublimeAutoHotkey后重启 - 补全关键词大小写敏感：
if可触发，IF不行；send可补全，Send不行
怎么让所有 .ahk 文件一打开就高亮？别改通用设置
想双击 .ahk 就高亮，不是在 Preferences → Settings 里加配置，而是在 Preferences → Settings – Syntax Specific 里操作——这个菜单只对当前语法生效。
步骤：
- 先打开一个
.ahk文件，确保右下角已显示AutoHotkey - 再打开
Preferences → Settings – Syntax Specific - 在右侧窗口粘贴：
{"extensions": ["ahk", "ahk2"]}
保存后，所有 .ahk 和 .ahk2 文件都会自动用该语法高亮。如果还无效，检查是否误装了其他同名插件，或手动删掉 %APPDATA%\Sublime Text 4\Packages\User 下残留的旧配置。
最常被忽略的一点：AHK v2 脚本默认不兼容 v1 构建系统，且 SublimeAutoHotkey 插件对 v2 的函数跳转支持仍弱于 v1——如果你重度依赖跳转，建议初期用 v1 开发，再逐步迁移到 v2。
