🚀 AutoHotkey v2 对象与类完全指南:从入门到原理
内容简介: 本教程全面讲解 AutoHotkey v2 的对象与类体系。从基础的对象字面量、引用类型概念,到类的定义、方法、动态属性、静态成员,再到进阶的原型链、引用计数、自定义枚举与错误对象。全文配有大量可运行的代码示例,适合从入门到进阶的各个阶段。
一、为什么你需要理解对象?
在 AutoHotkey v2 中,有四种主要的数据类型:
- **字符串**:如 `”Hello world”`
- **整数**:如 `123`
- **浮点数**:如 `123.45`
- **对象(Object)**
前三种叫「原始类型」,大家都很熟悉。而对象是 AHKv2 中最强大但也最容易被忽视的特性。
没有对象之前,你可能会这样写:
变量多了以后,重命名、传参、管理都变得痛苦。
有了对象之后:
现在如果你想改名 autoclicker → fnclicker,只需要改一处变量名。所有相关数据打包在一起,传递也只需传一个参数。
创建对象的几种方式
> 💡 小提示: 对象键名大小写不敏感,obj.Value、obj.VALUE、obj.value 都是同一个属性。
二、必须搞懂的第一个概念:引用
这是新手最容易踩的坑——对象是引用类型。
变量里存的不是对象本身,而是指向它的引用(可以理解为”门牌号”)。
对比原始类型
对象就不一样了
a 和 val 指向同一个对象,改谁都一样。
拷贝对象时也注意
> ⚠️ 踩坑: 如果你想要一个真正的「独立副本」,需要用 Clone() 方法:alias := val.Clone()
三、初阶:类(Class)入门
当你有多个相似对象时,一个个手写就太累了。类就是对象的”模板”。
定义和实例化
方法(Method)
方法是属于类的函数。调用时,AHK 会把实例本身作为隐藏参数 this 传进去。
> 注意: this 是自动传入的,不要写在参数列表中。写 ShowSpeed(this) 会报错。
箭头语法 GetInfo() => 表达式 等价于:
动态属性(Getters & Setters)
普通的字段就是直接存取值。但有时候你想在读写属性时执行代码——这就是动态属性。
只读属性
可读可写
通常用下划线 _ 开头的字段存储实际值:
箭头语法版:
什么时候用属性 vs 方法?
这是一个常见的设计困感,原教程作者给出了很好的指导:
用属性(Property)当:
- 它表示的**对象的数据或特征**。如 `Clicker.Speed`、`Window.Title`
- 读取它是”便宜的”且不会让你意外
- 读取没有明显的副作用——`x := obj.Value` 不应该弹窗或写文件
- 赋值意味着”设置新状态”
用方法(Method)当:
- 你在执行**动作或命令**。如 `Clicker.Start()`、`Clicker.Stop()`
- 操作有重要副作用——显示 GUI、写磁盘、发送输入
- 操作可能”很重”——`obj.RecalculateLayout()` 比 `obj.Layout` 更清晰
- 需要参数
一句话原则:
> 🔑 如果是”对象有啥”→ 属性;如果是”对象干啥”→ 方法
静态成员
类本身也是一个对象。加上 static 的属性属于类本身,而不是实例。
> 注意: 实例不能直接访问静态属性,类对象也不能直接访问实例属性:
> `autohotkey
> MsgBox Clicker.Speed ; 错误!类没有实例属性
> MsgBox ac1.DefaultSpeed ; 错误!实例没有静态属性
> `
类型检查
四、中阶:构造函数、析构函数与特殊属性
`__New` —— 构造函数
创建实例时自动调用。
Clicker() 的参数会传递给 __New(在隐藏的 this 之后)。
`static __New` —— 类构造函数
当代码执行到类定义、或第一次需要这个类时,static __New 会自动运行。
执行顺序:自动生成的 __Init → static __New
`__Init` —— 字段初始化
每个类都有一个自动生成的 __Init 方法,负责应用字段的初始值。
如果你自己定义了 __Init,基类的字段初始化不会自动执行,除非你显式调用 super.__Init()。
> ⚠️ 最佳实践: 要么完全靠字段赋值(字段 := 值),不自定义 __Init;要么自定义并记得调用 super.__Init()。
`__Delete` —— 析构函数
当对象不再被引用、即将被释放时调用。适合清理资源。
带参数的属性
属性也可以接受参数,用方括号语法:
`__Item` —— 默认索引属性
当对对象使用 obj[key] 语法时,走的是 __Item:
如果没定义 __Item,用空括号 c[] := 10 会创建一个名为 __Item 的值属性。
五、进阶:原型链与属性描述器
属性描述器
每个属性在内部由最多四个”槽位”描述:
- **Value** —— 存储的值(普通字段)
- **Get** —— getter 函数
- **Set** —— setter 函数
- **Call** —— 当属性被当作方法调用时使用的函数
普通字段只用了 Value 槽位:
用 DefineProp 可以手动定义动态属性:
原型链(Prototype Chain)
这是 AHK OOP 的底层机制,理解它你就掌握了”内力”。
每个类有三个层次:
- **类对象**(`Clicker`)—— 存储静态成员
- **原型对象**(`Clicker.Prototype`)—— 存储实例成员(方法、默认字段)
- **实例**(`ac := Clicker()`)—— `ac.base == Clicker.Prototype`
属性查找过程:
当 ac.Speed 被访问时,AHK:
- 先在 `ac` 自己身上找
- 没找到?顺着 `ac.base` → `Clicker.Prototype` 找
- 还没找到?→ `Object.Prototype` 找
4. 最后 → Any.Prototype
这就是为什么所有对象都能调用这些内置方法:
——它们都定义在 Object.Prototype 里。
继承时的原型链
原型链:
深入:AHK 是如何构建类的?
原教程作者手把手拆解了类定义背后的过程,非常值得一看:
- AHK 遇到 `class Clicker`,构建一个对象作为 Clicker 类对象
- 构建另一个对象作为原型(`Clicker.Prototype`),`base` 设为 `Object.Prototype`
- 为原型定义 `__Init` 方法(应用字段初始化)、`__Class` 属性(值 `”Clicker”`)
4. 为类对象定义 Prototype 属性,值为步骤 2 的原型对象
5. 类对象的 base 设为 Object 类对象
6. 遇到 class FastClicker extends Clicker 时,重复类似过程,但原型的 base 设为 Clicker.Prototype
> 💡 这些步骤完全可以用代码手动模拟,但用 class 语法当然要简单得多。
`is` vs `Type`
- `Type(obj)` —— 返回类名字符串(通过原型中的 `__Class` 属性)
- `obj is ClassName` —— 遍历原型链,检查是否有与 `ClassName.Prototype` 匹配的原型
如果你做了极端操作:
原始类型和 Any
整数、浮点数、字符串属于 Primitive → Any 分支,不继承自 Object。所以字符串没有 DefineProp,但有 HasProp(来自 Any.Prototype)。
但你也可以”借用”:
六、进阶:引用计数与指针
引用计数原理
AHKv2 用引用计数来管理对象的生命周期:
- 每当变量、数组元素、Map 条目、字段等开始持有对象的引用 → 计数 +1
- 每当这样的引用被覆盖或删除 → 计数 -1
- 计数降为 0 → 对象被释放 → 调用 `__Delete`(如果定义了)
对于绝大多数脚本,你完全不需要手动管理。 AHK 自动处理所有”正常引用”。
计数引用 vs 非计数引用
- **计数引用** —— AHK 追踪的常规引用(变量、字段、数组项、闭包等)。能保持对象存活。
- **非计数引用** —— 原始指针(存储为整数的内存地址)。不会保持对象存活。
如果只剩下非计数引用,对象可能被销毁而你手里还有个”僵尸指针”,使用它会崩溃。
`ObjPtr` vs `ObjPtrAddRef`
- `ObjPtr` 主要用于底层互操作(通过 `DllCall` 传指针、存到 `Buffer` 等)
- 如果你需要指针”算作一个引用”,用 `ObjPtrAddRef`,然后必须用 `ObjRelease` 平衡
`ObjFromPtr` vs `ObjFromPtrAddRef`
实战:将对象传给外部 DLL
原帖中 Cebolla 提供了一个完整的示例,iPhilip 在回复中指出了引用计数方面的错误,原作者随后修正。
正确的版本:
实战:在 Buffer 中存储对象指针
> ⚠️ 来自 iPhilip 的警告(原帖回复 #10):
> 实际使用中(如 EnumDisplayMonitors 的回调),必须用 ObjFromPtrAddRef 而不是 ObjFromPtr。他用两个完整示例证明了这一点。
什么时候你真的需要碰这些?
通常不需要! 即使是比较复杂的类、属性、GUI 项目,也不碰这些。
只有当你:
- 与外部 DLL 或 COM API 交互,需要存储对象指针
- 需要在二进制数据结构中序列化/嵌入对象指针
- 调试棘手的生命周期/析构问题
时才需要触及这些底层 API。
> 🔑 黄金法则:不确定就别碰。 让 AHK 自动管理引用计数就够了。
七、扩展:自定义枚举(__Enum)
for...in 循环在背后调用的是对象的 __Enum 方法。
- AHK 调用 `someObject.__Enum(变量数量)`
- `__Enum` 返回一个”枚举器”函数
- AHK 反复调用这个枚举器,传变量引用(`&k`, `&v`)
4. 枚举器给变量赋值,返回 true(继续)或 false(结束)
数组和 Map 已经内置了 __Enum:
扩展运算符 *
[m*] 中的 * 就是扩展运算符:
技巧:只收集 Map 的值:
来自原帖 #11 的评论者给出了这个巧妙的用法。
自定义 __Enum:模数序列
八、实战:自定义错误对象
原帖中 Rafaello 问了一个好问题:”我应该继承 Error 吗?”
Cebolla 给出了几种方案:
方案一:直接继承 Error(推荐)
方案二:不覆盖 __New
方案三(不推荐但展示了原理):通过 static Call
> 关键洞察: 要让一个对象拥有 Error 的属性(Message、File、Line、Stack、Extra),必须调用 Error.Prototype.__New。AHK 内部会检查该对象是否真的是 Error 类型,通过内部类型系统判断——即使你设置了 __Class := "Error" 也骗不过去(见原帖 Cebolla 的试验)。
九、综合实战:打造一个自动点击器类
把学到的所有知识串起来:
十、核心知识脑图
写在最后
这篇教程覆盖了很多内容,但你不需要一次全用上。在大多数脚本中,几个简单的类、方法和属性已经能让代码质量大大提升。
建议的练习路径:
- 把一组相关的变量打包成一个普通对象
- 把对象升级为一个类,添加方法
- 把”脏活”逻辑封装到整洁的属性或方法背后
4. 遇到重复代码时考虑继承
从小的开始,看看别人怎么用对象/类,多实验。

