AutoHotkey v2 对象与类完全指南:从入门到原理

从基础的对象字面量、引用类型概念,到类的定义、方法、动态属性、静态成员,再到进阶的原型链、引用计数、自定义枚举与错误对象。

🚀 AutoHotkey v2 对象与类完全指南:从入门到原理

内容简介: 本教程全面讲解 AutoHotkey v2 的对象与类体系。从基础的对象字面量、引用类型概念,到类的定义、方法、动态属性、静态成员,再到进阶的原型链、引用计数、自定义枚举与错误对象。全文配有大量可运行的代码示例,适合从入门到进阶的各个阶段。

一、为什么你需要理解对象?

在 AutoHotkey v2 中,有四种主要的数据类型:

  • **字符串**:如 `”Hello world”`
  • **整数**:如 `123`
  • **浮点数**:如 `123.45`
  • **对象(Object)**

前三种叫「原始类型」,大家都很熟悉。而对象是 AHKv2 中最强大但也最容易被忽视的特性。

没有对象之前,你可能会这样写:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

变量多了以后,重命名、传参、管理都变得痛苦。

有了对象之后:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

现在如果你想改名 autoclicker → fnclicker,只需要改一处变量名。所有相关数据打包在一起,传递也只需传一个参数。

创建对象的几种方式

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

> 💡 小提示: 对象键名大小写不敏感,obj.Value、obj.VALUE、obj.value 都是同一个属性。

二、必须搞懂的第一个概念:引用

这是新手最容易踩的坑——对象是引用类型。

变量里存的不是对象本身,而是指向它的引用(可以理解为”门牌号”)。

对比原始类型

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

对象就不一样了

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

a 和 val 指向同一个对象,改谁都一样。

拷贝对象时也注意

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

> ⚠️ 踩坑: 如果你想要一个真正的「独立副本」,需要用 Clone() 方法:alias := val.Clone()

三、初阶:类(Class)入门

当你有多个相似对象时,一个个手写就太累了。类就是对象的”模板”。

定义和实例化

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

方法(Method)

方法是属于类的函数。调用时,AHK 会把实例本身作为隐藏参数 this 传进去。

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

> 注意: this 是自动传入的,不要写在参数列表中。写 ShowSpeed(this) 会报错。

箭头语法 GetInfo() => 表达式 等价于:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

动态属性(Getters & Setters)

普通的字段就是直接存取值。但有时候你想在读写属性时执行代码——这就是动态属性。

只读属性

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

可读可写

通常用下划线 _ 开头的字段存储实际值:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

箭头语法版:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

什么时候用属性 vs 方法?

这是一个常见的设计困感,原教程作者给出了很好的指导:

用属性(Property)当:

  • 它表示的**对象的数据或特征**。如 `Clicker.Speed`、`Window.Title`
  • 读取它是”便宜的”且不会让你意外
  • 读取没有明显的副作用——`x := obj.Value` 不应该弹窗或写文件
  • 赋值意味着”设置新状态”

用方法(Method)当:

  • 你在执行**动作或命令**。如 `Clicker.Start()`、`Clicker.Stop()`
  • 操作有重要副作用——显示 GUI、写磁盘、发送输入
  • 操作可能”很重”——`obj.RecalculateLayout()` 比 `obj.Layout` 更清晰
  • 需要参数

一句话原则:

> 🔑 如果是”对象有啥”→ 属性;如果是”对象干啥”→ 方法

静态成员

类本身也是一个对象。加上 static 的属性属于类本身,而不是实例。

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

> 注意: 实例不能直接访问静态属性,类对象也不能直接访问实例属性:

> `autohotkey

> MsgBox Clicker.Speed ; 错误!类没有实例属性

> MsgBox ac1.DefaultSpeed ; 错误!实例没有静态属性

> `

类型检查

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

四、中阶:构造函数、析构函数与特殊属性

`__New` —— 构造函数

创建实例时自动调用。

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

Clicker() 的参数会传递给 __New(在隐藏的 this 之后)。

`static __New` —— 类构造函数

当代码执行到类定义、或第一次需要这个类时,static __New 会自动运行。

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

执行顺序:自动生成的 __Init → static __New

`__Init` —— 字段初始化

每个类都有一个自动生成的 __Init 方法,负责应用字段的初始值。

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

如果你自己定义了 __Init,基类的字段初始化不会自动执行,除非你显式调用 super.__Init()。

> ⚠️ 最佳实践: 要么完全靠字段赋值(字段 := 值),不自定义 __Init;要么自定义并记得调用 super.__Init()。

`__Delete` —— 析构函数

当对象不再被引用、即将被释放时调用。适合清理资源。

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

带参数的属性

属性也可以接受参数,用方括号语法:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

`__Item` —— 默认索引属性

当对对象使用 obj[key] 语法时,走的是 __Item:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

如果没定义 __Item,用空括号 c[] := 10 会创建一个名为 __Item 的值属性。

五、进阶:原型链与属性描述器

属性描述器

每个属性在内部由最多四个”槽位”描述:

  • **Value** —— 存储的值(普通字段)
  • **Get** —— getter 函数
  • **Set** —— setter 函数
  • **Call** —— 当属性被当作方法调用时使用的函数

普通字段只用了 Value 槽位:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

用 DefineProp 可以手动定义动态属性:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

原型链(Prototype Chain)

这是 AHK OOP 的底层机制,理解它你就掌握了”内力”。

每个类有三个层次:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

  1. **类对象**(`Clicker`)—— 存储静态成员
  1. **原型对象**(`Clicker.Prototype`)—— 存储实例成员(方法、默认字段)
  1. **实例**(`ac := Clicker()`)—— `ac.base == Clicker.Prototype`

属性查找过程:

当 ac.Speed 被访问时,AHK:

  1. 先在 `ac` 自己身上找
  1. 没找到?顺着 `ac.base` → `Clicker.Prototype` 找
  1. 还没找到?→ `Object.Prototype` 找

4. 最后 → Any.Prototype

这就是为什么所有对象都能调用这些内置方法:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

——它们都定义在 Object.Prototype 里。

继承时的原型链

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

原型链:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

深入:AHK 是如何构建类的?

原教程作者手把手拆解了类定义背后的过程,非常值得一看:

  1. AHK 遇到 `class Clicker`,构建一个对象作为 Clicker 类对象
  1. 构建另一个对象作为原型(`Clicker.Prototype`),`base` 设为 `Object.Prototype`
  1. 为原型定义 `__Init` 方法(应用字段初始化)、`__Class` 属性(值 `”Clicker”`)

4. 为类对象定义 Prototype 属性,值为步骤 2 的原型对象

5. 类对象的 base 设为 Object 类对象

6. 遇到 class FastClicker extends Clicker 时,重复类似过程,但原型的 base 设为 Clicker.Prototype

> 💡 这些步骤完全可以用代码手动模拟,但用 class 语法当然要简单得多。

`is` vs `Type`

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

  • `Type(obj)` —— 返回类名字符串(通过原型中的 `__Class` 属性)
  • `obj is ClassName` —— 遍历原型链,检查是否有与 `ClassName.Prototype` 匹配的原型

如果你做了极端操作:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

原始类型和 Any

整数、浮点数、字符串属于 Primitive → Any 分支,不继承自 Object。所以字符串没有 DefineProp,但有 HasProp(来自 Any.Prototype)。

但你也可以”借用”:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

六、进阶:引用计数与指针

引用计数原理

AHKv2 用引用计数来管理对象的生命周期:

  • 每当变量、数组元素、Map 条目、字段等开始持有对象的引用 → 计数 +1
  • 每当这样的引用被覆盖或删除 → 计数 -1
  • 计数降为 0 → 对象被释放 → 调用 `__Delete`(如果定义了)

对于绝大多数脚本,你完全不需要手动管理。 AHK 自动处理所有”正常引用”。

计数引用 vs 非计数引用

  • **计数引用** —— AHK 追踪的常规引用(变量、字段、数组项、闭包等)。能保持对象存活。
  • **非计数引用** —— 原始指针(存储为整数的内存地址)。不会保持对象存活。

如果只剩下非计数引用,对象可能被销毁而你手里还有个”僵尸指针”,使用它会崩溃。

`ObjPtr` vs `ObjPtrAddRef`

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

  • `ObjPtr` 主要用于底层互操作(通过 `DllCall` 传指针、存到 `Buffer` 等)
  • 如果你需要指针”算作一个引用”,用 `ObjPtrAddRef`,然后必须用 `ObjRelease` 平衡

`ObjFromPtr` vs `ObjFromPtrAddRef`

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

实战:将对象传给外部 DLL

原帖中 Cebolla 提供了一个完整的示例,iPhilip 在回复中指出了引用计数方面的错误,原作者随后修正。

正确的版本:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

实战:在 Buffer 中存储对象指针

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

> ⚠️ 来自 iPhilip 的警告(原帖回复 #10):

> 实际使用中(如 EnumDisplayMonitors 的回调),必须用 ObjFromPtrAddRef 而不是 ObjFromPtr。他用两个完整示例证明了这一点。

什么时候你真的需要碰这些?

通常不需要! 即使是比较复杂的类、属性、GUI 项目,也不碰这些。

只有当你:

  • 与外部 DLL 或 COM API 交互,需要存储对象指针
  • 需要在二进制数据结构中序列化/嵌入对象指针
  • 调试棘手的生命周期/析构问题

时才需要触及这些底层 API。

> 🔑 黄金法则:不确定就别碰。 让 AHK 自动管理引用计数就够了。

七、扩展:自定义枚举(__Enum)

for...in 循环在背后调用的是对象的 __Enum 方法。

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

  1. AHK 调用 `someObject.__Enum(变量数量)`
  1. `__Enum` 返回一个”枚举器”函数
  1. AHK 反复调用这个枚举器,传变量引用(`&k`, `&v`)

4. 枚举器给变量赋值,返回 true(继续)或 false(结束)

数组和 Map 已经内置了 __Enum:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

扩展运算符 *

[m*] 中的 * 就是扩展运算符:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

技巧:只收集 Map 的值:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

来自原帖 #11 的评论者给出了这个巧妙的用法。

自定义 __Enum:模数序列

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

八、实战:自定义错误对象

原帖中 Rafaello 问了一个好问题:”我应该继承 Error 吗?”

Cebolla 给出了几种方案:

方案一:直接继承 Error(推荐)

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

方案二:不覆盖 __New

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

方案三(不推荐但展示了原理):通过 static Call

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

> 关键洞察: 要让一个对象拥有 Error 的属性(Message、File、Line、Stack、Extra),必须调用 Error.Prototype.__New。AHK 内部会检查该对象是否真的是 Error 类型,通过内部类型系统判断——即使你设置了 __Class := "Error" 也骗不过去(见原帖 Cebolla 的试验)。

九、综合实战:打造一个自动点击器类

把学到的所有知识串起来:

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

十、核心知识脑图

隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

写在最后

这篇教程覆盖了很多内容,但你不需要一次全用上。在大多数脚本中,几个简单的类、方法和属性已经能让代码质量大大提升。

建议的练习路径:

  1. 把一组相关的变量打包成一个普通对象
  1. 把对象升级为一个类,添加方法
  1. 把”脏活”逻辑封装到整洁的属性或方法背后

4. 遇到重复代码时考虑继承

从小的开始,看看别人怎么用对象/类,多实验。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

给TA捐赠
共{{data.count}}人
人已捐赠
教程

AutoHotkey 文件自动整理脚本 [AutoHotkey 教程]

2026-6-30 12:30:11

教程

AutoHotkey从入门到精通 · 一、基本概念

2026-7-5 23:02:44

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
❯
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索