AutoHotkey v2 的语法变化,核心是 “删繁就简、统一规则”,下面用大白话拆成几个部分讲。 一、先说说删掉的旧语法(不用记这些了!
AutoHotkey v2 的语法变化,核心是 “删繁就简、统一规则”,下面用大白话拆成几个部分讲。
1. 删了 “直接写文本赋值” 的写法
以前可以写 var = value(比如 name = 小明),现在不行了,必须用 var := value(比如 name := "小明")—— 注意文本要加引号。
2. 删了 “老版 If 语句”,只剩一种 If 写法
以前可能有
IfEqual a, b 这种专门的 If 语句,现在全没了,只剩 “if 表达式”。
不用写括号也能生效(写了也没问题),比如:
- 简单的:
if a = b(判断 a 和 b 相等)
- 带括号的:
if (a + b > 10)(判断 a 加 b 大于 10)
3. 彻底没了 “命令”,全是 “函数调用”
以前有 “命令”(比如
WinMove)和 “函数”(比如
Add(1,2))的区别,现在统一成 “函数”,只是调用时可以省括号(前提是不用返回值)。
举个例子,以前的 WinMove, 100, 200 现在可以写:
- 省括号(不用返回值):
WinMove 100, 200(函数名和参数之间要空格,不能有逗号)
- 带括号(和省括号效果一样):
WinMove(100, 200)
还要注意这几点:
- 所有文本参数必须加引号,比如
MsgBox "你好"(以前可能不用);
- 变量不用套百分号了(比如以前
%name%,现在直接写 name),除非是 #Include 这类特殊指令;
- 不用写
% (百分号加空格)强制表达式了,现在默认都是表达式。
4. 删了 “Gosub” 和 “标签当函数用”
以前可以用
Gosub 标签名 跳转到标签,或者把标签传给
SetTimer/
Hotkey,现在全不行了 —— 因为 “函数” 能完全代替标签,还能有局部变量、返回值,更灵活。
比如以前用标签写热键的逻辑,现在直接用函数就行,还不容易出错。
以前热键是 “标签”(比如 #n::标签名),现在自动变成 “函数”,规则更简单:
- 单行热键:
#n::MsgBox "按了Win+N"(直接写逻辑)
- 多行热键:用大括号包起来,不用写
return 结尾(以前要写),比如:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
- 想手动调用热键:可以给热键函数起名字,比如
::myHotkey(ThisHotkey){...}(ThisHotkey 会自动拿到热键本身,比如 #n)
注意:热键里的变量默认是 “局部的”,想改全局变量得先写 global 变量名,不然改的是局部变量。
1. 函数和变量共用 “命名空间”
简单说:定义一个函数,就等于创建了一个 “只读变量”,比如:
- 定义函数
f(a,b){return a+b},就相当于有个变量 f,值是这个函数;
- 调用时可以直接用变量名,比如
myVar := f,然后 myVar(1,2) 就能算出 3(不用写 %myVar%() 了)。
传函数给其他函数(比如 SetTimer)时,直接写函数名,不用加引号,比如 SetTimer f, 1000(以前可能要写 "f")。
2. 命名不能乱起,有明确限制
- 不能以数字开头(比如
123name 不行,name123 可以);
- 不能用
@ # $ 这些符号(以前可能允许);
- 只能用:字母、数字、下划线(
_)、非英文符号(比如中文、日文)。
3. 有些词不能当名字(“保留关键字”)
比如
if、
local、
global、
for、
while、
true、
false 这些 —— 因为这些词是语法自带的,用了会出错。
举个例子:不能写 if := 1(把 if 当变量名),不然程序不知道你是要判断还是用变量。
“作用域” 就是 “变量能在哪个范围用”,现在规则很简单:
- 没有 “超级全局变量” 了(以前有些变量全脚本都能改,现在没了);
- 函数里默认能 “读” 全局变量,但不能 “改”—— 想改全局变量,必须先写
global 变量名,比如:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
- 函数里的变量默认是 “局部的”(只能在函数里用),和其他函数的变量不冲突(比如两个函数都叫
temp,互不影响)。
另外,“强制局部模式” 也删了,不用再纠结要不要加 #ForceLocal 了。
“表达式” 就是算值的式子(比如 1+2、a>b),现在规则更统一,不容易出错。
1. 字符串写法更灵活
- 可以用双引号(
"你好")或单引号('你好'),但开头和结尾要一致;
- 字符串里想写引号,有两种办法:
- 用 ` 类似的转义符(比如
"他说:`“你好`”",显示 他说:”你好”);
- 里外换不同的引号(比如
"他说:'你好'",不用转义)。
2. 运算符有几个小变化
and/or 不再只返回 1/0,而是返回实际值:比如 "" or "默认值" 会返回 “默认值”(以前返回 1),想要纯布尔值(1/0)可以写 !!(x or y);
- 字符串拼接必须加空格:比如
"我叫" name(拼接 “我叫” 和变量 name),以前可能不用空格,现在不加会报错;
- 多语句表达式(用逗号分隔)的结果是最后一个:比如
x:=1, y:=2 结果是 2(以前是 1);
- 新增
!== 运算符:和 == 对应,用来 “区分大小写的不相等”(!= 不区分大小写,比如 "A" != "a" 是 false,"A" !== "a" 是 true);
- 数字运算符更严格:比如
//(整除)、|(位运算)这些,传浮点数会报错(以前会偷偷转整数)。
3. 新增 “is 运算符”:判断值的类型
比如想检查 x 是不是整数,写 x is Integer;想检查是不是字符串,写 x is String—— 比以前的 IsInteger(x) 更直观。
4. 取地址 / 引用变明确了
- 以前用
&var 取变量地址,现在不行了:取字符串地址用 StrPtr(var),取对象地址用 ObjPtr(obj);
- 现在
&var 是 “传引用”(比如给函数传变量的引用,让函数能改这个变量),专门用在 ByRef 参数里。
5. 新增 “胖箭头函数”:简写函数
如果函数逻辑简单(只有一行返回值),可以用 => 简写,比如:
- 普通写法:
add(a,b){return a+b}
- 简写:
add(a,b) => a+b(效果完全一样)
还能在函数里用,比如内层函数简写,更省代码。
“对象” 就是存键值对的容器(比如数组、字典),现在规则更明确,主要变了这几点:
1. 访问 “属性” 和 “数据” 要分开
- 用
. 访问 “属性”(对象自带的功能):比如 dict.Count(获取字典里的元素个数,这是属性);
- 用
[] 访问 “数据”(自己存的键值对):比如 dict["name"](获取 name 这个键对应的值)。
2. 创建对象的语法有小调整
还是用 {键: 值},但键如果是变量的值,要加 %,比如:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
结果:obj1.var 是 “小明”,obj2.name 是 “小明”。
3. 调用父类方法用 super,不用 base 了
以前用 base.Method() 调用父类的方法,现在换成 super.Method(),而且如果父类没有这个方法,会直接报错(以前会偷偷忽略,不容易发现问题)。
4. 调用对象的方法更明确
以前可能用 fn.() 调用对象的无名方法,现在不行了,必须调用 Call 方法,比如 fn() 其实是 fn.Call()—— 规则更统一,不容易混淆。
七、函数调用:规矩更严,可变参数更灵活
1. 不能 “多传参数” 动态调用了
简单说:
函数要多少参数,就必须传多少,不能多传(以前可能偷偷忽略多的参数,现在直接报错)。
比如函数 Add(a,b){return a+b},只能传 2 个参数,传 Add(1,2,3) 会报错。
2. 可变函数:省参数名能省内存
“可变函数” 就是能接收任意多个参数的函数(比如 Join(sep, params*)),以前每次调用都会创建一个数组存多余参数,现在可以省略参数名(只用 *),避免创建无用数组,适合不需要多余参数的场景(比如回调函数):
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
3. 可变调用支持更多对象(不只是数组了)
以前可变调用(比如 Array(arr*))只能传 “连续数字键的数组”(比如 [1,2,3]),现在支持任何可枚举对象(比如 Map、集合),如果对象每次迭代返回多个值,只取第一个:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
4. 新增 unset:判断参数 “到底传没传”
以前可选参数没传值,会用默认值(比如 Add(a,b,c:=0),没传 c 就用 0),现在可以用 unset 当默认值,明确区分 “传了空值” 和 “没传值”,再用 IsSet() 判断:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
八、ByRef 传参:必须显式写 &,更安全
“ByRef” 就是 “传引用”—— 让函数能直接改外面的变量(不是改副本),现在规则变严了,必须手动写 &,避免误操作:
1. 调用时必须加 &,不然报错
以前可能隐式传引用(比如 Swap(a,b)),现在必须写 &变量名,明确告诉程序 “要传引用”:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
如果传错了(比如传个数字 Swap(1,2)),会直接报错,不会默默失败。
2. 函数里能检查引用状态
函数里可以用这些判断:
param is VarRef:检查参数是不是引用;
IsSetRef(param):检查引用的变量有没有值;
%param%:解引用(拿到引用变量的实际值)。
3. 递归时能传之前的局部变量引用
比如递归函数里,能把上一层的局部变量引用传给下一层,以前做不到,现在更灵活。
九、嵌套函数:函数里能写函数,还能 “记仇”
1. 函数里定义的函数,能 “捕获” 外层变量
简单说:在函数 A 里定义函数 B,B 能记住 A 里的变量,就算 A 执行完了,B 还能用这些变量(这叫 “闭包”):
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
2. 能用胖箭头 => 简写嵌套函数
如果嵌套函数逻辑简单(只有一行返回值),可以用 => 简写,省代码:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
十、一堆小语法调整:更规整,少踩坑
以前可能写 var = 123,现在必须写 var := 123(文本要加引号,比如 var := "abc")。
以前 return %var% 等于 return var(直接返回变量值),现在是 “先解引用再返回”—— 比如 var := "num", num := 10,return %var% 会返回 10(先把 var 解成 num,再拿 num 的值)。
- 默认路径:相对于当前文件的文件夹(以前可能乱找);
- 参数能加引号:比如
#Include "lib\tools.ahk",更清晰。
标签名只能用:字母、数字、下划线(
_)、非英文符号(比如中文),不能用特殊字符(
@#$),也不能以数字开头。
而且函数里的标签,只能在函数里用,外面调不到(以前可能冲突)。
- 循环结束后,
k 和 v 会恢复成循环前的值(以前可能被改乱);
- 如果
obj 不是对象(比如传个数字),会报错(以前默默不执行);
- 最多能写 19 个变量(比如
for a,b,c,d in obj),也能省略变量(比如 for ,v in obj 只要值,不要键)。
- 和循环一起:如果循环一次都没执行(比如
for k,v in emptyObj),会走 Else;
- 和
Catch 一起:如果 Try 里没报错,会走 Else。
注意:如果不用大括号,Else 可能绑错对象,比如:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
所以一定要加大括号,把循环包起来:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
十一、类型:变量类型更严格,不 “偷偷变身”
以前变量可能 “既是字符串又是数字”(比如 var := "123",用的时候可能自动转数字),现在类型固定:
str := "123" 永远是字符串,用的时候要转数字(比如 str + 1 会自动转,但类型还是字符串);
int := 123 永远是整数,不会变成字符串;
true/false 这些内置值,返回的是整数(1/0),不是字符串。
带引号的字符串如果是数字格式(比如 "0xA" 是十六进制 10),能直接参与计算:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
- 两个都是字符串:按字母序比(比如
"54" > "530",因为第一个字符 5=5,第二个 4>3);
- 一个是数字、一个是字符串:按数字比(比如
54 > "530",因为 54 < 530,结果是 false);
</> 这些运算符,不能用在非数字字符串上(比如 "abc" > "def" 会报错),要用 StrCompare(a,b) 比较。
用这些函数转类型,转不了会报错:
Integer("123"):转整数(Integer("12a") 会报错);
Float("12.3"):转浮点数;
String(123):转字符串;
Type(123):查看类型(返回 “整数”)。
十二、对象:分清楚 Array、Map,不用再猜
以前对象又像列表又像字典,现在拆成三种明确类型:Object(基础对象)、Array(列表)、Map(字典)。
- 用
[] 或 Array() 创建:arr := [1,2,3] 或 arr := Array(1,2,3);
- 用
[] 访问元素(arr[1] 是 1),用 . 访问属性(arr.Length 是 3);
- 索引不能超范围(比如
arr[4] 会报错),要加元素用 arr.Push(4)。
- 用
Map() 创建:m := Map("name","小明", "age",20);
- 用
[] 访问值(m["name"] 是 “小明”);
- 键区分大小写(
m["Name"] 和 m["name"] 是两个不同的键);
- 没找到键会报错,想给默认值用
m.Get("key", "默认值")。
以前创建对象用 new Array(),现在直接写 Array() 或 [],比如:
arr := Array(1,2,3)(创建数组);
m := Map("a",1)(创建 Map)。
以前元函数(__get/__set 这些)规则复杂,现在变成普通方法,参数是数组,比如:
__get(name, args):获取属性时触发;
__set(name, args, value):设置属性时触发;
- 要调用父类的元函数,直接写
super.__get(name, args),不用记特殊规则。
十三、枚举器与绑定函数:迭代和传参更灵活
以前用 _NewEnum() 迭代,现在用 __Enum(n)(n 是循环里的变量个数),用 Call() 拿下一个值:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
用 Bind() 绑定函数时,能留空参数,后面调用时补全,比如:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
以前 COM 对象都是 “一锅烩”,现在分成了几个明确的 “类”,方便识别和操作:
- ComValue:所有 COM 包装对象的 “祖宗”,其他类型都从它来;
- ComObject:最常用的类型,对应有效的 COM 对象(比如 Excel 应用、IE 窗口),可以直接用对象语法调用(比如
obj.Method());
- ComObjArray:专门处理 COM 数组(SafeArrays),比如从其他程序拿到的列表数据;
- ComValueRef:处理 “引用类型” 的 COM 数据(VT_BYREF),比如需要修改外部变量的参数。
可以用
is 运算符检查类型,比如
if obj is ComObject 就知道这是个能直接调用的 COM 对象。
另外,除了 ComObject,其他几种类型(ComValue、ComObjArray、ComValueRef)可以自定义属性和方法(改它们的原型就行)。
以前用 ComObjCreate(CLSID) 创建 COM 对象,现在直接用 ComObject(CLSID),比如创建 Excel 对象:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
如果旧代码报错 “TypeError”(比如给 ComObject 传了整数),大概率是该用 ComValue 而不是 ComObject。
以前有
ComObjParameter、
ComObject(vt, value) 等多个函数,现在统一成
ComValue,用来创建特定类型的 COM 封装数据。
它会自动把 value 转成 COM 需要的类型(按 COM 规则),比如:
- 传整数时,会正确转成 R4(单精度浮点数)、R8(双精度浮点数)等类型;
- 传指针时,可以直接用整数地址或对象。
简单说:需要包装一个特定类型的 COM 数据,就用 ComValue(类型, 值)。
如果有个 COM 对象的指针(地址),想用它创建 AHK 能操作的对象,用这个函数。和旧版相比,它不会自动增加引用计数(AddRef),更安全。
旧版等价写法是 ComObject(9, dsp, 1),但新版更直接。
很多 COM 对象现在有个 Ptr 属性,能直接拿到它们的底层指针,方便传给 DllCall、NumPut 等函数:
- ComObjArray(数组):
Ptr 是数组的 SAFEARRAY 指针;
- ComValueRef(引用类型):
Ptr 是被引用变量的地址;
- 空接口指针的 ComObject:
Ptr 可以读写(非空后变成只读),方便函数返回后直接用,不用手动包装。
比如给 DllCall 传 COM 对象的指针,直接写 DllCall("xxx", "Ptr", obj.Ptr) 就行。
以前遍历 COM 数组(ComObjArray)的方式很特殊,现在和 AHK 的普通数组(Array)一致了:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
索引从数组的 “下限” 开始(通常是 0,和多数编程语言一致)。
- 整数类型(I1、I8、UI1 等)现在转成 AHK 的整数,不是字符串了(以前可能转成字符串,容易出错);
- 错误类型(VT_ERROR)不再转成整数,而是生成一个 ComValue 对象,方便处理错误详情。
有些 COM 对象有 “默认属性”—— 不用写属性名,直接操作对象就会触发的属性,比如:
- 集合对象的 “Item” 属性(访问集合中的元素);
- 某些对象的 “值” 属性(比如 VBScript 里
MsgBox obj 会自动取对象的默认值)。
在 v2 中:
obj[x] 会自动调用对象的默认属性(比如 obj[1] 等价于 obj.Item(1));
- 有些 COM 对象(比如 JavaScript 数组)不公开默认属性,这时不能用
[] 访问元素,得用 arr.%i%(i 是索引变量)。
注意:把 AHK 的 Array 传给 JavaScript 时,JS 用 arr[i] 访问不到元素(因为 JS 会找属性,不是数组元素)。
调用 COM 对象的方法时,如果参数是 “引用类型”(VT_BYREF,需要修改外部变量的值),v2 处理更简单:
- 会自动创建临时变量,复制调用者的变量值,传给 AHK 函数;
- 函数里可以用两种方式修改这个值:
- 声明参数为
&变量名(ByRef),直接赋值(比如 bCancel := true);
- 不解引用,用
%参数名% := true 赋值。
举个例子,处理一个 “取消操作” 的引用参数:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
以前需要用 NumPut 或操作 ComObjRef 对象,现在简单多了。
删除的命令, 函数 & 指令
| 删除的 |
备注 |
| Asc() |
请使用 Ord 代替. |
| AutoTrim |
请使用 Trim 代替. |
| ComObjMissing() |
改为连续写两个逗号. |
| ComObjUnwrap() |
(如果需要, 请使用 ComObjValue 和 ObjAddRef. |
| ComObjEnwrap() |
如果需要, 请使用 ComObjFromPtr 和 ObjAddRef. |
| ComObjError() |
|
| ComObjXXX() |
如果 XXX 是显式定义的 ComObj 函数以外的任何东西, 请使用 ComObjActive, ComValue 或 ComObjFromPtr 代替. |
| ControlSendRaw |
请使用 ControlSend "{Raw}" 或 ControlSendText 代替. |
| EnvDiv |
请使用 / 或 /= 代替, 例如 a /= b. |
| EnvMult |
请使用 * 或 *= 代替, 例如 a *= b. |
| EnvUpdate |
它的用处非常有限, 可以用一个简单的 SendMessage 代替: SendMessage(0x1A, 0, StrPtr("Environment"), 0xFFFF). |
| Exception |
请使用 Error 或一个适当的子类. |
| FileReadLine |
请使用 文件读取循环或 FileOpen 代替. |
| Func |
请使用 MyFunc 这样的直接引用代替. |
| Gosub |
|
Gui GuiControl GuiControlGet |
请参阅 Gui. |
| IfEqual |
请使用 If 和 = 代替, 例如 if a = b. |
| IfExist |
请使用 If 和 FileExist 代替, 例如 if FileExist(...). |
| IfGreater |
请使用 If 和 > 代替, 例如 if a > b. |
| IfGreaterOrEqual |
Use If 和 >= 代替, 例如 if a >= b. |
| IfInString |
请使用 If 和 InStr 代替, 例如 if InStr(...). |
| IfLess |
请使用 If 和 < 代替, 例如 if a < b. |
| IfLessOrEqual |
请使用 If 和 <= 代替, 例如 if a <= b. |
| IfMsgBox |
MsgBox 现在返回按钮名称. |
| IfNotEqual |
请使用 If 和 != 代替, 例如 if a != b. |
| IfNotExist |
Use If 和 FileExist 代替, 例如 if not FileExist(...). |
| IfNotInString |
请使用 If 和 InStr 代替, 例如 if not InStr(...). |
| IfWinActive |
请使用 If 和 WinActive 代替, 例如 if WinActive(...). |
| IfWinExist |
请使用 If 和 WinExist 代替, 例如 if WinExist(...). |
| IfWinNotActive |
请使用 If 和 WinActive 代替, 例如 if not WinActive(...). |
| IfWinNotExist |
请使用 If 和 WinExist 代替, 例如 if not WinExist(...). |
| If between |
请参阅 If 示例 #5. |
| If in/contains |
请参阅 If 示例 #6. |
| If is |
请参阅 isXXX. |
| Input |
请使用 InputHook 代替. |
| IsByRef |
请参阅 ByRef 限制. |
| IsFunc |
|
| Menu |
请使用 Menu/MenuBar 类, TraySetIcon, A_IconTip, A_IconHidden 和 A_AllowMainWindow. |
| MenuGetHandle |
请使用 Menu.Handle 代替. |
| MenuGetName |
没有菜单名称; MenuFromHandle 是最接近的替代方法. |
| Progress |
请使用 Gui 代替. |
| SendRaw |
请使用 Send "{Raw}" 或 SendText 代替. |
| SetBatchLines |
-1 现在是默认行为. |
| SetEnv |
请使用 := 代替. |
| SetFormat |
Format 可以用来格式化字符串. |
SoundGet SoundSet |
请参阅 Sound 函数. |
SoundGetWaveVolume SoundSetWaveVolume |
在平衡方面与 SoundGet 和 SoundSet 的行为略有不同, 但都没有保留平衡. |
| SplashImage |
请使用 Gui 代替. |
| SplashTextOn/Off |
请使用 Gui 代替. |
| StringCaseSense |
!= 不区分大小写( 但 !== 被添加为区分大小写的不相等), 并且 = 和 != 只忽略 ASCII 字符的大小写. 添加 StrCompare 用于使用任何模式比较字符串. 各种字符串函数现在都有一个 CaseSense 参数, 可用于指定是否区分大小写或区域设置模式. |
| StringGetPos |
请使用 InStr 代替. |
StringLeft StringLen StringMid StringRight StringTrimLeft StringTrimRight |
请使用 SubStr 代替. |
| StringReplace |
Use StrReplace 代替. |
| StringSplit |
请使用 StrSplit 代替. |
| Transform |
请使用数学函数和运算符代替. 有关 Transform Deref, 请参阅 RegExMatch 示例 #8. 有关 Transform HTML, 请参阅 HTML Entities Encoding. |
| VarSetCapacity |
对二进制数据/结构, 请使用 Buffer 对象, 对 UTF-16 字符串, 请使用 VarSetStrCapacity. |
| WinGetActiveStats |
请使用 WinGetTitle 和 WinGetPos 代替. |
| WinGetActiveTitle |
请使用 WinGetTitle 代替, 例如 WinGetTitle "A". |
| #CommentFlag |
|
| #Delimiter |
|
| #DerefChar |
|
| #EscapeChar |
|
| #HotkeyInterval |
请使用 A_HotkeyInterval 代替. |
| #HotkeyModifierTimeout |
请使用 A_HotkeyModifierTimeout 代替. |
#IfWinActive #IfWinExist #IfWinNotActive #IfWinNotExist |
请参阅 #HotIf 优化. |
| #InstallKeybdHook |
请使用 InstallKeybdHook 代替. |
| #InstallMouseHook |
请使用 InstallMouseHook 代替. |
| #KeyHistory |
请使用 KeyHistory N 代替. |
| #LTrim |
如果需要, 请使用 LTrim 选项. |
| #MaxHotkeysPerInterval |
请使用 A_MaxHotkeysPerInterval 代替. |
| #MaxMem |
每个变量的最大容量现在没有限制. |
| #MenuMaskKey |
请使用 A_MenuMaskKey 代替. |
| #NoEnv |
现在是默认行为. |
重命名的命令, 函数 & 指令
| v1 Name |
v2 Name |
| ComObjCreate() |
ComObject, 它现在是一个类 |
| ComObjParameter() |
ComValue, 它现在是一个类 |
| DriveSpaceFree |
DriveGetSpaceFree |
| EnvAdd |
DateAdd |
| EnvSub |
DateDiff |
| FileCopyDir |
DirCopy |
| FileCreateDir |
DirCreate |
| FileMoveDir |
DirMove |
| FileRemoveDir |
DirDelete |
| FileSelectFile |
FileSelect |
| FileSelectFolder |
DirSelect |
| #If |
#HotIf |
| #IfTimeout |
HotIfTimeout |
| StringLower |
StrLower 和 StrTitle |
| StringUpper |
StrUpper 和 StrTitle |
| UrlDownloadToFile |
Download |
| WinMenuSelectItem |
MenuSelect |
| LV, TV 和 SB 函数 |
GuiControl 的方法 |
| File.__Handle |
File.Handle |
以前 Chr(0) 可能不好使,现在能返回一个包含 “二进制零” 的字符串(长度 1),方便处理二进制数据。
- 成功等到剪贴板内容:返回
1(true);
- 超时没等到:返回
0(false);
- 去掉了
ErrorLevel,不用再检查它;
- 传
0 表示 “等最短时间”,不再等同于 0.5 秒。
发送 Alt 键事件时,BlockInput 不再临时关闭。以前是为了兼容老 Windows XP 的 bug,现在系统新了,就没必要了。
- 如果脚本是从标准输入(stdin)读的,
Edit 啥也不做;
- 不再默认处理
.ini 文件(老版本会特殊照顾 .ini,现在不用了)。
- 默认不转换行尾(
\n/\r\n),和 FileOpen 保持一致;
- 新增
Options 参数,可指定编码(比如 "UTF-8"),替代老版本的前缀(如 *P65001);
- 加
"RAW" 选项可读写二进制数据(FileRead 会返回 Buffer 对象,方便处理字节);
FileAppend 可以直接写 Buffer 对象,不做任何转换。
以前打开文件失败可能默默不吭声,现在直接抛异常(红框报错),逼着你处理错误(用 Try/Catch)。
- 多选时返回路径数组(比如
["C:\a.txt", "C:\b.txt"]),不再是用换行分隔的字符串;
- 支持选文件夹:加
D 选项(比如 FileSelect("D", "C:\"));
- 用新的 Windows API,不会乱改当前工作目录;
- 默认过滤器不再有多余的 “文本文档 (*.txt)”,更干净。
如果源路径没通配符(*/?)又找不到文件,直接抛异常;但如果有通配符(比如 *.txt)却没匹配到,不算错。
- 参数顺序调整:
Control, WinTitle, WinText, ... 总是放最后,好记;
- 接受 HWND:
Control 参数可以是控件的 HWND(窗口句柄,整数),或带 Hwnd 属性的对象(比如 GUI 控件);
- 坐标变了:
ControlMove/ControlGetPos 用 “客户端坐标”(从窗口内容区左上角算,不含标题栏和边框),和 GUI 控件一致;
ControlGetFocus 返回控件的 HWND(句柄),不再是 ClassNN(比如 Edit1)。
- 参数顺序调整:
WinTitle, WinText, ... 放最后,和 Control 函数统一;
- 接受 HWND:
WinTitle 可以是窗口句柄(整数),或带 Hwnd 属性的对象(比如 GUI 窗口);
WinMove 不再认 “DEFAULT” 关键字,省略参数或传空字符串就行;
WinWait/WinWaitActive 找到窗口后返回它的 HWND,超时返回 0,去掉了 ErrorLevel。
不管系统里有没有交换鼠标左右键,Left 始终指左键(主按钮),Right 始终指右键(副按钮),避免 confusion。
用 RGB 颜色(比如 0xFF0000 是红色),不再是 BGR,和其他函数统一。找不到颜色或出错时抛异常,去掉 ErrorLevel。
- 以前可以写标签名或函数名,现在必须传函数对象(比如
Hotkey "^s", SaveFunc);
- 支持
S 选项:让热键不被 Suspend 暂停(相当于 #SuspendExempt);
- 用
HotIf 系列函数替代老的 “Hotkey If” 子命令,支持 and/or 表达式(比如 HotIf WinActive("Chrome") and WinExist("Popup"))。
简单的 WinActive()/WinExist() 检查会被快速处理(像 v1 的 #IfWin),性能更好。比如 #HotIf WinActive("Chrome") 会被优化,响应更快。
热键里直接写 Suspend 不再自动豁免暂停,必须用 #SuspendExempt 指令或 S 选项(比如 Hotkey "^s", SaveFunc, "S")。
- 支持 64 位整数(范围更大);
- 不传参数返回
0.0~1.0 的浮点数(以前返回整数);
- 传一个参数(如
Random(9))返回 0~9 的数(以前默认上限是 2147483647);
- 用系统随机数生成器,更靠谱,不用手动 “播种”。
- 支持
Buffer 对象(二进制数据容器),自动受 Buffer 大小限制;
StrPut 返回字节数,方便直接传给 Buffer() 创建对应大小的缓冲区。
- 必须返回匹配对象(老版本的
O 选项成了默认);
- 匹配对象的属性更清晰:
match.Pos 是位置,match.Len 是长度,子匹配用 match[1] 而不是 match.Value(1)。
- 用法变了:
Output := Sort(Input, Options, Callback),输入输出分开;
- 排序更稳定:两个元素相等时,保持原始顺序;
- 支持 “逻辑比较”(
CLogical 选项),比如按数字大小排 "10" 和 "2"(以前按字符排会把 "10" 放 "2" 前面)。
- 根键和子键合并写:比如
RegRead("HKCU\Software\MyApp", "Version"),不用分开传;
RegDelete 删值更明确:省略 KeyName 时删默认值,删子键用新的 RegDeleteKey;
RegRead 有 Default 参数:没找到时返回默认值,不抛异常。
- 去掉
UseErrorLevel 选项,出错抛异常(用 Try/Catch 处理);
RunWait 返回程序的退出代码(比如正常退出是 0)。
wParam 和 lParam 必须是整数或带 Ptr 属性的对象,传字符串会报错;
- 失败或超时抛异常,返回消息回复,去掉
ErrorLevel。
比如 WinExist()、ControlGetHwnd() 等,返回窗口 / 控件的句柄(整数),不再是十六进制字符串,方便直接用在 DllCall 等地方。
比如 GetKeyState("CapsLock") 返回 1(开)或 0(关),Suspend(1) 暂停,Suspend(0) 恢复,更符合表达式逻辑。
- 去掉
UseUnsetLocal 等选项(因为读未定义变量会直接报错);
- 新增
VarUnset 警告:第一次用没赋值过的变量时提醒你(默认弹窗)。
Exit 只退出当前线程,脚本等最后一个线程结束才终止,保证 Finally 代码块执行(比如释放资源)。
DllCall 是用来调用系统或第三方 DLL 文件里的函数的,v2 里规则更明确,不容易出错:
以前可能写 DllCall("user32.dll\MessageBox", UInt, 0, Str, "内容", Str, "标题", UInt, 0),现在类型名(如 UInt、Str)必须用引号括起来,否则会把变量名当类型,报错:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
如果 DLL 函数要给你的字符串变量写内容(输出参数),v2 会检查字符串是否 “正常结束”(有没有二进制零),如果发现异常(比如缓冲区溢出),会直接终止程序,防止出错。
另外:
- 普通
AStr(ANSI 字符串)现在只能 “输入”,不能 “输出”(因为缓冲区大小不够);
- 如果 DLL 返回新的字符串地址(比如
Str* 参数),v2 会自动把新字符串赋值给你的变量,不用手动处理地址。
以前传指针只能用整数,现在可以传带 Ptr 属性的对象(比如 Buffer、ComObject),方便处理二进制数据或 COM 对象:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
- 如果参数是数字类型(比如
Int、UInt),传非数字(如空字符串)会报错;
- 要接收 DLL 的输出值(比如
Int* 类型参数),必须传 “变量引用”(用 &变量名),不然收不到值:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
以前的 Loop, File、Loop, Reg 现在改了名字和参数,更直观:
代替旧的 Loop, FilePattern [, IncludeFolders, Recurse],现在用 Loop Files "文件路径" "模式",模式可以是:
F:只找文件;
D:只找文件夹;
R:递归找(包括子文件夹);
- 组合:
RF(递归找文件)、RD(递归找文件夹)。
例子:递归找 C 盘所有 .txt 文件
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
代替旧的 Loop, RootKey [, Key, IncludeSubkeys, Recurse],现在用 Loop Reg "注册表路径" "模式",模式和文件循环类似(R 递归)。
例子:遍历 HKCU 下的 Software 子键
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
注意:没了 A_LoopRegSubKey,现在 A_LoopRegKey 直接包含完整路径。
v2 的 InputBox 语法简化了,返回一个对象,包含 “用户操作结果” 和 “输入的内容”,不用再记复杂的参数顺序:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
- 选项:空格分隔,比如
Password(密码框,输入隐藏)、T5(5 秒超时)、w300(宽度 300);
- 返回对象的属性:
Result:OK(用户点了确定)、Cancel(取消)、Timeout(超时);
Value:用户输入的内容(取消 / 超时则为空)。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
v2 的 MsgBox 也简化了,支持更多直观选项,返回用户点击的按钮名称(比如 OK、Cancel):
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
- 选项:空格分隔,常用的有:
- 按钮组合:
OKCancel(OK + 取消)、YesNo(是 + 否)、RetryCancel(重试 + 取消);
- 图标:
Icon!(警告)、Icon?(疑问)、Iconi(信息);
- 超时:
T3(3 秒自动关闭,返回 Timeout);
- 默认按钮:
Default2(第二个按钮为默认)。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
以前的 ControlGet、WinGet、DriveGet 这些 “主命令” 全被删掉了,改成了单独的小函数,比如 ControlGetChecked()、WinGetID(),更易记、更规范。
- 函数名对应功能:比如 “检查控件是否勾选” 就是
ControlGetChecked(),“获取窗口句柄” 就是 WinGetID();
- 返回值更明确:比如
WinGetID("记事本") 直接返回窗口的句柄(整数),不是字符串;
- 失败抛异常:找不到窗口 / 控件时,直接报错(用
Try/Catch 处理),不再检查 ErrorLevel。
v2 加了很多新函数,专门解决以前需要复杂代码才能实现的功能:
创建一块 “内存缓冲区”,用来存字节数据(比如 DLL 返回的二进制、文件读取的字节),比变量更方便:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
准确获取文本插入点(光标)的 X/Y 坐标,避免以前 A_CaretX/A_CaretY 的缓存问题:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
以前 ClipboardAll 是变量,现在是函数,能完整保存剪贴板的所有内容(比如图片、文件),还能恢复:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
以前要靠 FileExist("文件夹\*") 间接判断,现在直接用 DirExist:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
脚本开始执行前,提前加载需要的 DLL 文件,避免后面调用时临时加载的延迟:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
v2 对内置变量做了大整理,重点是:
- 加 A_前缀:所有系统内置变量都带
A_(比如 Clipboard 改成 A_Clipboard);
- 返回整数:以前返回字符串的数字变量(比如
WinExist()),现在返回整数;
- 删除冗余:没用的变量全删了(比如
A_CaretX 用 CaretGetPos 代替)。
操作文件的 File 对象(比如 FileOpen 创建的)现在规则更严:
- 属性和方法不能混用:比如
FileObj.Pos 是属性(获取当前位置),不能写成 FileObj.Pos()(方法调用);
- 参数错误直接报错:比如给只读属性赋值(如
FileObj.Pos := 100,Pos 是只读),会抛出异常;
- File.Tell () 删掉了:用
FileObj.Pos 代替(获取当前位置)。
先搞懂一个概念:对象就是 “装着数据和功能的盒子”。
- 比如一个 “窗口” 是
Gui 对象,盒子里有 “显示窗口”“销毁窗口”“加按钮” 这些功能(叫 “方法”),还有 “窗口标题”“背景色” 这些信息(叫 “属性”);
- 一个 “按钮” 是
GuiControl 对象,盒子里有 “改按钮文本”“判断是否被点击” 这些方法和属性。
以前用命令(比如 Gui New 创建窗口,Gui Add Button 加按钮),现在直接创建对象:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
用 Gui() 函数创建,括号里可以传窗口标题、样式等参数:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
Gui 对象常用属性(改窗口信息):
guiWin.Title:改窗口标题(比如 guiWin.Title := "新标题");
guiWin.BackColor:改窗口背景色(比如 guiWin.BackColor := "FFE4B5",浅橙色);
guiWin.Hwnd:获取窗口句柄(整数,用于调用系统函数)。
用
Gui对象.Add(控件类型, 选项, 初始文本) 加控件,返回的就是 “控件对象”,可以存到变量里反复操作。
常见控件类型:Button(按钮)、Edit(输入框)、Text(静态文本)、ListBox(列表框)。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
- 加控件时用
v控件名 选项(比如 vusername),后续可以通过 Gui对象["控件名"] 获取控件对象(比如 guiWin["username"]);
- 用
Gui对象.Submit() 一次性获取所有命名控件的值,返回一个 “键值对数组”(比如 {username: "小明", password: "123"}),不用再定义全局变量存值了!
以前用 g-label(比如 gBtnClick)处理控件事件,还要在标签里判断 A_GuiEvent 是什么(点击、双击、选中等),现在直接给控件注册特定事件,函数只处理一种情况,更简单。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
事件处理函数会自动收到两个参数:
ctrl:触发事件的控件对象(比如按钮、输入框);
info:事件的详细信息(比如点击的坐标、选中的项目索引)。
不用再查 A_Gui、A_GuiControl 这些内置变量了!
以前用 Gui Show、Gui Font 这些命令,现在直接调用 Gui 对象的 “方法”(功能)和 “属性”(信息)。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
直接用 GuiControl 对象的属性:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
v2 删了一些 v1 的旧功能,改用更简单的方式实现:
- 没有 “默认 GUI”:必须用 Gui 对象变量操作窗口(比如
guiWin.Show()),不能像 v1 那样省略;
- 控件值不会自动存变量:必须用
Gui对象.Submit() 或 GuiControl对象.Value 获取值;
- 事件函数里用
ctrl.Gui 找窗口:比如按钮的 ctrl.Gui 就是它所属的窗口对象,不用再记窗口名;
- DPI 适配更好:高 DPI 屏幕下,控件尺寸和边距会自动调整,比 v1 更清晰。
以前靠 ErrorLevel 判断错误(比如 FileOpen 失败后 ErrorLevel=1),现在全改成 “抛异常”—— 出错时直接中断代码,必须用 Try/Catch 处理,避免错误被忽略。
ErrorLevel 彻底删除!所有函数失败时都会 “抛异常”(比如找不到文件、窗口不存在),必须用 Try 包裹可能出错的代码,用 Catch 处理错误。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
以前要抓特定错误,得在 Catch 里手动检查错误信息;现在 Catch 可以直接指定 “错误类型”,只处理目标错误,其他错误继续往上抛。
常见错误类型:
TimeoutError:超时(比如 SendMessage 超时);
TargetError:目标不存在(比如找不到窗口、控件);
OSError:系统错误(比如文件权限不够);
ValueError:值无效(比如给只读变量赋值)。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
OnError 是全局错误回调函数,现在能处理 “快退出脚本” 的关键错误(比如内存不足),还能控制是否继续运行:
- 回调函数会收到第二个参数,决定行为:
Return:返回 -1 继续当前线程,返回 0/1 退出线程;
Exit:不支持继续,返回非零停止后续处理;
ExitApp:关键错误(比如内存溢出),返回非零仍会终止脚本。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
大部分错误对话框会多一个 “继续” 选项 —— 选了之后,出错的函数返回空字符串,脚本继续运行(不用强制退出)。比如调用 DllCall 传错参数,选 “继续” 后,DllCall 返回 "",脚本接着跑。
v2 对表达式和函数的错误检测更严,以前能 “蒙混过关” 的情况,现在会直接报错:
以前热串的冒号(:)分隔符规则混乱,现在统一:
- 用第一对冒号当分隔符,比如
::触发文本::替换文本;
- 触发文本里的冒号要转义(加
\),比如 ::5\:::6 表示 “输入 5: 时替换成 6”。
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分
以前不管热键需不需要 Win/Alt 键,只要物理键按下,就会屏蔽松开事件;现在只有 “热键本身需要 Win/Alt 键”(比如 #n、!a),才会屏蔽松开,避免影响其他操作。
v2 优化了很多默认设置,以前要手动写的指令(比如 #NoEnv、SetBatchLines -1),现在默认就生效,省代码!
以前脚本只要有 OnMessage 或钩子就不退出,现在规则更明确 —— 只有满足以下条件之一,脚本才 “持续运行”,否则执行完就退出:
- 有自定义热键 / 热字串;
- 有可见的 GUI 窗口;
- 有启用的定时器(
SetTimer);
- 有
OnClipboardChange 回调;
- 有激活的
InputHook(监听输入);
- 手动调用了
Persistent()(强制持续运行)。
注意:OnMessage 不再让脚本持续运行,需要手动加 Persistent() 才能保持脚本不退出。
正则匹配换行时,默认支持 \r(回车)、\n(换行)、\r\n(Windows 换行),不用再手动加 (*ANYCRLF) 选项。
以前脚本命令行参数存在 1、2 这些变量里,现在统一存到 A_Args 数组里,比如运行 script.ahk 张三 20,A_Args[1] 是 “张三”,A_Args[2] 是 “20”。
只支持 Windows Vista 及以上系统(Win7/8/10/11),不用再兼容老系统的 bug,功能更稳定。
- 对象里不能存带二进制零的字符串当 “键”,但可以当 “值”;
- 把对象和字符串拼接(比如
obj + "abc")会报错,以前会偷偷当空字符串,现在更严格;
- 变量没赋值就用,会直接报错(以前可能默默给空值),可以用
IsSet(var) 先检查变量有没有值。
NEXT STEP
读完了,下一步做点什么?
这篇文章的代码可以直接用。想更快出成果,往下选一条。
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。