AHK 变量作用域讲清楚：global、local、static、ByRef 怎么选

AHK v1 的变量作用域，是很多新手从“能写脚本”走向“能维护脚本”时必须补的一课。尤其是函数里为什么读不到外面的变量，什么时候要写 global，static 和 ByRef 又分别解决什么问题，这些概念不弄清楚，脚本一大就会乱。

先说结论：函数外面的普通变量默认是全局变量，但函数内部默认使用局部变量；函数内写 global name 是声明要访问某个全局变量；函数第一行单独写 global 是“假设全局模式”；而在函数外，也就是主代码区域写 global name，在 AHK v1.1.05+ 里还有“超级全局变量”的含义。官方帮助文档可以参考：AutoHotkey v1 函数 - 全局变量。

一、先理解默认规则

在 AHK v1 里，函数外面的变量通常是全局变量；函数内部默认使用局部变量。也就是说，函数里写的 count 和函数外面的 count，默认不是同一个变量。

#Requires AutoHotkey v1.1
#NoEnv
#SingleInstance Force

count := 10
ShowCount()
MsgBox, % "函数外 count = " count
return

ShowCount() {
    count := 1
    MsgBox, % "函数内 count = " count
}

这段代码里，函数内的 count := 1 不会改掉函数外的 count := 10。这是好事，因为函数不会随便污染外面的变量。

二、global：先分清三种写法

global 在 AHK v1 里要按位置和写法区分。它不只是“函数里用外部变量”这么简单。

• 函数内写 global count：声明这个函数要读写外部全局变量 count。
• 函数第一行单独写 global：让该函数进入假设全局模式，除了参数和显式声明的 local 变量外，变量默认按全局处理。
• 主代码区域写 global count：在 AHK v1.1.05+ 中，count 会成为超级全局变量，默认对函数可见，强制局部模式函数除外。

count := 0

F1::
AddCount()
MsgBox, %count%
return

AddCount() {
    global count
    count++
}

上面是最常见的写法：只在需要的函数里声明某个全局变量。这种方式边界清楚，适合大多数脚本。

三、主代码里的 global：超级全局变量

AHK v1 里还有一个容易被忽略的点：如果 global 声明出现在任何函数外面，它默认会对所有函数有效。官方文档称之为“超级全局变量”。这可以避免每个函数里重复写同一个 global 声明，但也会让变量影响范围变大。

global AppName := "AHK66"

ShowApp()
return

ShowApp() {
    ; AppName 在主代码区被声明为超级全局变量，
    ; 所以这里不写 global AppName 也能读取。
    MsgBox, %AppName%
}

超级全局变量适合少量真正全局的配置，例如程序名、配置路径、共享对象等。不建议把普通业务变量都声明成超级全局，否则函数之间会过度耦合，后期很难判断变量在哪里被修改。

另外提醒一句：AHK v2 已经没有“超级全局变量”的概念。写 v2 脚本或迁移 v1 代码时，不要依赖主代码区 global 自动影响所有函数的行为。

四、local：强调函数内部变量

函数内部默认就是 local，但在复杂函数里，你可以用 local 明确告诉自己和读代码的人：这个变量只在函数里使用。

BuildText(name, score) {
    local line
    line := "姓名：" name "，分数：" score
    return line
}

AHK v1.1.27+ 还支持强制局部模式：如果函数第一行是单独的 local，变量引用会更严格地按局部处理，超级全局变量也不会在未声明时自动可见。这种写法适合想减少隐式全局影响的脚本。

五、static：函数里的记忆变量

static 表示变量属于函数，但不会在函数结束后丢失。它适合计数、缓存、初始化一次的对象。

F2::
MsgBox, % NextId()
return

NextId() {
    static id := 0
    id++
    return id
}

每次调用 NextId()，id 都会保留上一次的值。这比用一堆全局变量更干净，因为它只暴露函数结果，不把内部状态散落在外面。

六、ByRef：把变量本身传进去修改

普通参数传入函数后，函数拿到的是值；如果希望函数直接修改调用方的变量，可以用 ByRef。

text := "  AHK66  "
TrimInPlace(text)
MsgBox, [%text%]
return

TrimInPlace(ByRef value) {
    value := Trim(value)
}

ByRef 适合需要返回多个结果、原地修改变量、避免复制大文本的场景。但它也会让函数副作用变强，所以不要滥用。

七、怎么选

八、推荐原则

• 能用参数传进去，就不要直接读全局变量。
• 能用返回值拿出来，就不要用 global 改外部变量。
• 只有少量真正跨函数共享的配置，才考虑超级全局变量。
• 需要函数记住状态时，用 static 比全局变量更整洁。
• 需要修改调用方变量时，再用 ByRef。

作用域不是为了增加麻烦，而是为了让脚本变大后仍然可控。变量在哪里创建、在哪里修改、在哪里失效，心里有数，脚本就不容易出怪问题。