免费AutoHotkey教程：如何编写并运行第一个Windows自动化热键脚本

【免费下载链接】AutoHotkeyAutoHotkey - macro-creation and automation-oriented scripting utility for Windows.项目地址: https://gitcode.com/gh_mirrors/au/AutoHotkey

回复同一封确认邮件、往同一张表里填同一个客户编号——这类重复劳动可以交给脚本。AutoHotkey 是一款免费的 Windows 自动化工具，它的热键脚本能自动完成键盘与鼠标操作。本教程带你从零写出并跑通第一个自动化脚本。

📦 AutoHotkey 能做什么：热键绑定、模拟输入与脚本逻辑

一句话定位：AutoHotkey 是面向 Windows 自动化的脚本解释器，写几行文本、保存，电脑替你执行。三项核心能力：

• 热键绑定：把任意物理按键关联到一组操作上，按一下就执行，相当于自己定义的快捷指令。
• 模拟键鼠输入：让脚本替你"打字"和"点击"，不用动手也能完成输入。
• 脚本逻辑：变量、循环、条件判断，把一次动作串成一条连续的流程。

这三项能力可以单独使用，组合起来就是完整的自动化流水线，后面会逐步把它们拼在一起。

💻 安装 AutoHotkey v2 并确认托盘图标就绪

本仓库是 v2 版源码，v1 已停止维护，所以安装 v2 版本：

1. 从官方渠道下载 v2 安装包。
2. 运行安装程序，保持默认选项一路下一步。
3. 安装完成后，系统托盘出现绿色 AHK 图标，说明运行环境就绪；没有就重新跑一遍安装程序。

程序主入口在 source/AutoHotkey.cpp，README 中说明 v2 支持 Windows 7 及以后的系统。想自己从源码编译，可参考仓库 README 里的构建说明。

💡 第一个 AutoHotkey 脚本：MsgBox 消息框演示与 .ahk 文件说明

新建一个文本文件，保存为first.ahk。.ahk是 AutoHotkey 脚本的专属后缀，后缀正确时右键菜单里才会出现"Run Script"选项。内容只有两行：

; 我的第一个 Windows 自动化脚本 MsgBox "你好，这是脚本弹出的消息框！"

右键该文件选择"Run Script"，或者直接双击，屏幕上会弹出一个消息框。两个约定：以;开头的行是注释，解释器直接跳过；MsgBox是弹出消息框的命令，它的源码位于 source/lib/InputBox.cpp。

🔑 热键绑定教程：用冒号把按键和动作关联起来

把脚本改成热键形式：

F1::MsgBox "你好，热键生效了！"

语法规则只有一句：冒号左边是按键，冒号右边是动作。可以把它理解成给实体按键接门铃——F1 是按钮，冒号后面是按下后发生的事。现在按键盘上的 F1，消息框就会弹出来。按键监听与动作派发实现在 source/hotkey.cpp。

✍️ Send 命令用法：让脚本替你自动打字

再加一条热键：

F2::Send "你好，这是脚本打出来的文字"

按下 F2，脚本会把这句话在当前光标位置"逐字敲"出来。Send通过系统 SendInput 接口模拟键盘输入，每个字符、每个按键都被精确注入，效果等同于真实打字。实现位于 source/keyboard_mouse.cpp。提醒一句：Send 只影响当前聚焦的窗口，打字前先把光标移进目标窗口。固定表单字段、重复确认输入这类场景，都靠这条命令。

🧮 AutoHotkey 变量赋值与 Loop 循环写法

三个要点，逐条看：

F3:: { n := 1 Loop 5 { MsgBox "第 " n " 次循环" n++ } }

• 赋值：n := 1给变量 n 初始值 1，相当于先把袋子里放进 1 个球。
• 变量展开：v2 里字符串中的变量用花括号{n}展开，也可以直接空格拼接，两种都正确。
• 循环：Loop 5表示循环体执行 5 遍，n 每遍加 1，就像绕操场跑 5 圈、每圈记一次数。

表达式的解析由 source/script_expression.cpp 里的引擎负责。

🧩 实战组合：一键填充表单三个字段的热键脚本示例

把热键、Send 和循环组合成一件真正有用的事：每天要填同一张反馈表。

; 按 Ctrl+Shift+F 依次填好表单的三个字段 ^+f:: { Send "zhangwei@example.com" Send {Tab} Send "AutoHotkey 实战组" Send {Tab} Send "运营部" }

^+f是组合键写法，代表 Ctrl+Shift+F；{Tab}模拟按下 Tab 键跳到下一个输入框。按下热键前只需把鼠标点到第一个输入框，三个字段就会依次填好。把三行文字换成你表单里的内容，就得到一个专属小工具。

❓ AutoHotkey 脚本不生效排查：四个常见坑与回答

• 问：双击 .ahk 文件没反应，为什么？答：文件其实存成了.txt。Windows 默认隐藏已知扩展名，"first.ahk"可能实际叫"first.ahk.txt"。在资源管理器里打开"文件扩展名"显示再检查一遍。
• 问：热键写好了，按键却没反应？答：两种可能：脚本根本没在运行（托盘没有图标），或者热键被其他软件占用，比如输入法快捷键。换 F12 这类冷门键验证一下。
• 问：脚本能开机自启吗？答：可以。按 Win+R 输入shell:startup，把 .ahk 文件的快捷方式拷进打开的文件夹，下次开机自动执行。
• 问：网上旧教程的语法 v2 不认？答：v1 与 v2 语法有差异，比如 v1 循环写作Loop, 5带逗号，v2 是Loop 5；v2 的变量展开用花括号。一律按 v2 语法写。

🧭 AutoHotkey 进阶方向：从 GUI 到窗口控制的三条路线

基础跑通之后，可以沿这三个方向扩展：

• GUI 界面：用脚本画出带按钮和输入框的可视化工具，源码在 source/script_gui.cpp。
• 窗口控制：操作任意窗口的激活、标题与位置，源码在 source/window.cpp。
• 正则表达式：对复杂文本做精确匹配与替换，内置的 PCRE 引擎位于 source/lib_pcre/。

今天挑一件你工作台上最重复的活，把它写进一个 .ahk 文件，能跑起来的那个，就是你写下的第一个 Windows 自动化脚本。

【免费下载链接】AutoHotkeyAutoHotkey - macro-creation and automation-oriented scripting utility for Windows.项目地址: https://gitcode.com/gh_mirrors/au/AutoHotkey