AHK 自动执行段是什么：为什么 return 前后的代码表现不一样

很多 AHK 新手第一次遇到“代码写在 return 前”和“代码写在 return 后”表现不一样时，会以为是 return 这个命令很神秘。其实真正需要理解的是：AHK 脚本启动后，会先从文件顶部开始执行一段代码，这段区域通常叫 自动执行段。

自动执行段决定了脚本启动时先做什么：设置全局环境、初始化变量、创建 GUI、启动定时器、注册托盘菜单、读取配置等。遇到第一个 return、热键、热字符串、标签等结构时，自动执行段通常就结束了。后面的代码不是不会执行，而是要等热键、标签、函数调用或定时器触发。

一、先看最典型的例子

#Requires AutoHotkey v1.1
#NoEnv
#SingleInstance Force

MsgBox, 这行在自动执行段里，脚本启动就会执行。
return

MsgBox, 这行通常不会自动执行。

F1::
MsgBox, 按下 F1 才会执行这里。
return

这个脚本启动后，只会弹出第一条消息。第二个 MsgBox 虽然写在文件里，但它位于 return 后面，又不属于任何会被主动调用的结构，所以脚本启动时不会跑到那里。

二、return 前通常放初始化代码

自动执行段适合放“脚本启动时就该准备好”的东西，例如环境设置、全局变量初始化、定时器、托盘菜单、GUI 创建等。它更像脚本的启动入口。

#NoEnv
#SingleInstance Force
SetTitleMatchMode, 2

configPath := A_ScriptDir "\config.txt"

; 读取文本文件的第一行
FileReadLine, delayMs, %configPath%, 1

SetTimer, CheckWindow, 1000
return

CheckWindow:
    if WinExist("记事本")
        ToolTip, 找到记事本窗口
return

这段代码里，SetTimer 写在自动执行段里，所以脚本启动后定时器就会开始工作；而 CheckWindow: 是标签，只有定时器触发时才执行。

三、return 后的代码并不是“无效代码”

return 后面可以放热键、热字符串、标签、函数。它们不会在启动时顺着执行，但会在对应事件发生时执行。

MsgBox, 脚本启动
return

F2::
    SayHello("F2")
return

::addr::北京市朝阳区示例路 66 号

ShowTime:
    FormatTime, now,, yyyy-MM-dd HH:mm:ss
    MsgBox, %now%
return

SayHello(from) {
    MsgBox, % "来自 " from " 的调用"
}

这里的热键、热字符串、标签和函数都写在 return 后面，但它们各有自己的触发方式。理解这一点后，就不会再把 return 后面的代码误认为“不会运行”。

四、新手最常见的错误

• 把本该启动时执行的初始化代码写到了第一个 return 后面。
• 在热键前面忘了写 return，导致启动时意外执行到后面的普通代码。
• 以为脚本从上到下会一直执行完整个文件。
• 把标签当函数用，结果流程跳转后难以维护。
• 在自动执行段里写了耗时循环，导致热键响应变慢。

五、推荐结构

; 1. 指令和全局设置
#NoEnv
#SingleInstance Force

; 2. 初始化变量
isRunning := false

; 3. 启动时要做的事
TrayTip, AHK, 脚本已启动, 1
return

; 4. 热键区
F1::
isRunning := !isRunning
ToolTip, % isRunning ? "运行中" : "已暂停"
return

; 5. 标签区
DoWork:
return

; 6. 函数区
Log(msg) {
    FileAppend, %A_Now% - %msg%`n, %A_ScriptDir%\run.log
}

真正要记住的不是“return 前能执行，return 后不能执行”，而是：脚本启动只会自动执行启动流程，后面的代码要靠事件或调用进入。