ahkv1->ahkv2变化,通俗易懂版:语法规则大更新(主要是删旧加新)

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 当变量名),不然程序不知道你是要判断还是用变量。

四、变量的 “作用域” 更清晰(不用记 “超级全局” 了)

“作用域” 就是 “变量能在哪个范围用”,现在规则很简单:
 
  1. 没有 “超级全局变量” 了(以前有些变量全脚本都能改,现在没了);
  2. 函数里默认能 “读” 全局变量,但不能 “改”—— 想改全局变量,必须先写 global 变量名,比如:
     
    隐藏内容,支付积分后阅读
    已经有1人购买查看了此内容
    15
    15积分

     
  3. 函数里的变量默认是 “局部的”(只能在函数里用),和其他函数的变量不冲突(比如两个函数都叫 temp,互不影响)。
另外,“强制局部模式” 也删了,不用再纠结要不要加 #ForceLocal 了。

五、表达式怎么写?更统一,更少坑

“表达式” 就是算值的式子(比如 1+2、a>b),现在规则更统一,不容易出错。

1. 字符串写法更灵活

  • 可以用双引号("你好")或单引号('你好'),但开头和结尾要一致;
  • 字符串里想写引号,有两种办法:
  1. 用 ` 类似的转义符(比如 "他说:`“你好`”",显示 他说:”你好”);
  2. 里外换不同的引号(比如 "他说:'你好'",不用转义)。

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积分

 

十、一堆小语法调整:更规整,少踩坑

 

1. 变量初始化必须用 :=,不能用 =

以前可能写 var = 123,现在必须写 var := 123(文本要加引号,比如 var := "abc")。

2. return %var% 现在是 “双重引用”

以前 return %var% 等于 return var(直接返回变量值),现在是 “先解引用再返回”—— 比如 var := "num", num := 10,return %var% 会返回 10(先把 var 解成 num,再拿 num 的值)。

3. #Include 路径更直观

  • 默认路径:相对于当前文件的文件夹(以前可能乱找);
  • 参数能加引号:比如 #Include "lib\tools.ahk",更清晰。

4. 标签名规则和变量一样

标签名只能用:字母、数字、下划线(_)、非英文符号(比如中文),不能用特殊字符(@#$),也不能以数字开头。
 

而且函数里的标签,只能在函数里用,外面调不到(以前可能冲突)。

5. for 循环更安全

  • 循环结束后,k 和 v 会恢复成循环前的值(以前可能被改乱);
  • 如果 obj 不是对象(比如传个数字),会报错(以前默默不执行);
  • 最多能写 19 个变量(比如 for a,b,c,d in obj),也能省略变量(比如 for ,v in obj 只要值,不要键)。

6. Else 能和循环、Catch 一起用了

  • 和循环一起:如果循环一次都没执行(比如 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),不是字符串。

1. 字符串也能当数字用

带引号的字符串如果是数字格式(比如 "0xA" 是十六进制 10),能直接参与计算:
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

2. 比较规则更明确

  • 两个都是字符串:按字母序比(比如 "54" > "530",因为第一个字符 5=5,第二个 4>3);
  • 一个是数字、一个是字符串:按数字比(比如 54 > "530",因为 54 < 530,结果是 false);
  • </> 这些运算符,不能用在非数字字符串上(比如 "abc" > "def" 会报错),要用 StrCompare(a,b) 比较。

3. 能手动转类型

用这些函数转类型,转不了会报错:
 
  • Integer("123"):转整数(Integer("12a") 会报错);
  • Float("12.3"):转浮点数;
  • String(123):转字符串;
  • Type(123):查看类型(返回 “整数”)。

十二、对象:分清楚 Array、Map,不用再猜

 

以前对象又像列表又像字典,现在拆成三种明确类型:Object(基础对象)、Array(列表)、Map(字典)。

1. Array:就是列表,索引从 1 开始

  • 用 [] 或 Array() 创建:arr := [1,2,3] 或 arr := Array(1,2,3);
  • 用 [] 访问元素(arr[1] 是 1),用 . 访问属性(arr.Length 是 3);
  • 索引不能超范围(比如 arr[4] 会报错),要加元素用 arr.Push(4)。

2. Map:就是字典,键值对存储

  • 用 Map() 创建:m := Map("name","小明", "age",20);
  • 用 [] 访问值(m["name"] 是 “小明”);
  • 键区分大小写(m["Name"] 和 m["name"] 是两个不同的键);
  • 没找到键会报错,想给默认值用 m.Get("key", "默认值")。

3. 没有 new 关键字了

以前创建对象用 new Array(),现在直接写 Array() 或 [],比如:
 
  • arr := Array(1,2,3)(创建数组);
  • m := Map("a",1)(创建 Map)。

4. 元函数简化成普通方法

以前元函数(__get/__set 这些)规则复杂,现在变成普通方法,参数是数组,比如:
 
  • __get(name, args):获取属性时触发;
  • __set(name, args, value):设置属性时触发;
  • 要调用父类的元函数,直接写 super.__get(name, args),不用记特殊规则。

十三、枚举器与绑定函数:迭代和传参更灵活

 

1. 枚举器:迭代对象更明确

以前用 _NewEnum() 迭代,现在用 __Enum(n)(n 是循环里的变量个数),用 Call() 拿下一个值:
 
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

2. 绑定函数:参数能 “留空补位”

用 Bind() 绑定函数时,能留空参数,后面调用时补全,比如:
 
 
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

十四、COM 对象分类型了,更好区分

以前 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)可以自定义属性和方法(改它们的原型就行)。

十五、创建 COM 对象的函数变了,更直观

1. 创建普通 COM 对象:用 ComObject(CLSID)

以前用 ComObjCreate(CLSID) 创建 COM 对象,现在直接用 ComObject(CLSID),比如创建 Excel 对象:
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 
如果旧代码报错 “TypeError”(比如给 ComObject 传了整数),大概率是该用 ComValue 而不是 ComObject。

2. 创建封装对象:用 ComValue(vt, value)

以前有 ComObjParameter、ComObject(vt, value) 等多个函数,现在统一成 ComValue,用来创建特定类型的 COM 封装数据。
 

它会自动把 value 转成 COM 需要的类型(按 COM 规则),比如:

  • 传整数时,会正确转成 R4(单精度浮点数)、R8(双精度浮点数)等类型;
  • 传指针时,可以直接用整数地址或对象。
简单说:需要包装一个特定类型的 COM 数据,就用 ComValue(类型, 值)。

3. 从指针创建 COM 对象:ComObjFromPtr(pdsp)

如果有个 COM 对象的指针(地址),想用它创建 AHK 能操作的对象,用这个函数。和旧版相比,它不会自动增加引用计数(AddRef),更安全。
 

旧版等价写法是 ComObject(9, dsp, 1),但新版更直接。

十六、Ptr 属性:方便获取指针,和其他函数交互

很多 COM 对象现在有个 Ptr 属性,能直接拿到它们的底层指针,方便传给 DllCall、NumPut 等函数:
  • ComObjArray(数组):Ptr 是数组的 SAFEARRAY 指针;
  • ComValueRef(引用类型):Ptr 是被引用变量的地址;
  • 空接口指针的 ComObject:Ptr 可以读写(非空后变成只读),方便函数返回后直接用,不用手动包装。
比如给 DllCall 传 COM 对象的指针,直接写 DllCall("xxx", "Ptr", obj.Ptr) 就行。

十七、ComObjArray 枚举:和普通数组一样用

以前遍历 COM 数组(ComObjArray)的方式很特殊,现在和 AHK 的普通数组(Array)一致了:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 
索引从数组的 “下限” 开始(通常是 0,和多数编程语言一致)。

十八、数据类型转换:更合理

  • 整数类型(I1、I8、UI1 等)现在转成 AHK 的整数,不是字符串了(以前可能转成字符串,容易出错);
  • 错误类型(VT_ERROR)不再转成整数,而是生成一个 ComValue 对象,方便处理错误详情。

十九、默认属性:COM 对象的 “隐含操作”

有些 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),更方便

调用 COM 对象的方法时,如果参数是 “引用类型”(VT_BYREF,需要修改外部变量的值),v2 处理更简单:
  • 会自动创建临时变量,复制调用者的变量值,传给 AHK 函数;
  • 函数里可以用两种方式修改这个值:
    1. 声明参数为 &变量名(ByRef),直接赋值(比如 bCancel := true);
    2. 不解引用,用 %参数名% := 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

 

二一、基础输入输出与系统交互

1. Chr(0):支持二进制零

以前 Chr(0) 可能不好使,现在能返回一个包含 “二进制零” 的字符串(长度 1),方便处理二进制数据。

2. ClipWait:返回结果更直接

  • 成功等到剪贴板内容:返回 1(true);
  • 超时没等到:返回 0(false);
  • 去掉了 ErrorLevel,不用再检查它;
  • 传 0 表示 “等最短时间”,不再等同于 0.5 秒。

3. SendEvent 与 BlockInput

发送 Alt 键事件时,BlockInput 不再临时关闭。以前是为了兼容老 Windows XP 的 bug,现在系统新了,就没必要了。

4. Edit 命令:更规矩

  • 如果脚本是从标准输入(stdin)读的,Edit 啥也不做;
  • 不再默认处理 .ini 文件(老版本会特殊照顾 .ini,现在不用了)。

二二、文件操作:更统一,更安全

1. FileAppend/FileRead:编码和转换更明确

  • 默认不转换行尾(\n/\r\n),和 FileOpen 保持一致;
  • 新增 Options 参数,可指定编码(比如 "UTF-8"),替代老版本的前缀(如 *P65001);
  • 加 "RAW" 选项可读写二进制数据(FileRead 会返回 Buffer 对象,方便处理字节);
  • FileAppend 可以直接写 Buffer 对象,不做任何转换。

2. FileOpen:失败就报错

以前打开文件失败可能默默不吭声,现在直接抛异常(红框报错),逼着你处理错误(用 Try/Catch)。

3. FileSelect(原 FileSelectFile):选文件 / 文件夹更方便

  • 多选时返回路径数组(比如 ["C:\a.txt", "C:\b.txt"]),不再是用换行分隔的字符串;
  • 支持选文件夹:加 D 选项(比如 FileSelect("D", "C:\"));
  • 用新的 Windows API,不会乱改当前工作目录;
  • 默认过滤器不再有多余的 “文本文档 (*.txt)”,更干净。

4. FileCopy/FileMove:没找到文件就报错

如果源路径没通配符(*/?)又找不到文件,直接抛异常;但如果有通配符(比如 *.txt)却没匹配到,不算错。

二三、窗口与控件操作:参数更合理

1. Control 系列函数(ControlClick/ControlSend 等)

  • 参数顺序调整:Control, WinTitle, WinText, ... 总是放最后,好记;
  • 接受 HWND:Control 参数可以是控件的 HWND(窗口句柄,整数),或带 Hwnd 属性的对象(比如 GUI 控件);
  • 坐标变了:ControlMove/ControlGetPos 用 “客户端坐标”(从窗口内容区左上角算,不含标题栏和边框),和 GUI 控件一致;
  • ControlGetFocus 返回控件的 HWND(句柄),不再是 ClassNN(比如 Edit1)。

2. Win 系列函数(WinActivate/WinMove 等)

  • 参数顺序调整:WinTitle, WinText, ... 放最后,和 Control 函数统一;
  • 接受 HWND:WinTitle 可以是窗口句柄(整数),或带 Hwnd 属性的对象(比如 GUI 窗口);
  • WinMove 不再认 “DEFAULT” 关键字,省略参数或传空字符串就行;
  • WinWait/WinWaitActive 找到窗口后返回它的 HWND,超时返回 0,去掉了 ErrorLevel。

3. MouseClick/MouseClickDrag:按钮不随系统设置变

不管系统里有没有交换鼠标左右键,Left 始终指左键(主按钮),Right 始终指右键(副按钮),避免 confusion。

4. PixelSearch/PixelGetColor:颜色格式变了

用 RGB 颜色(比如 0xFF0000 是红色),不再是 BGR,和其他函数统一。找不到颜色或出错时抛异常,去掉 ErrorLevel。

二四、热键与热字符串:更灵活,更明确

1. Hotkey 函数:只认函数对象

  • 以前可以写标签名或函数名,现在必须传函数对象(比如 Hotkey "^s", SaveFunc);
  • 支持 S 选项:让热键不被 Suspend 暂停(相当于 #SuspendExempt);
  • 用 HotIf 系列函数替代老的 “Hotkey If” 子命令,支持 and/or 表达式(比如 HotIf WinActive("Chrome") and WinExist("Popup"))。

2. #HotIf:更智能

简单的 WinActive()/WinExist() 检查会被快速处理(像 v1 的 #IfWin),性能更好。比如 #HotIf WinActive("Chrome") 会被优化,响应更快。

3. Suspend:豁免暂停更明确

热键里直接写 Suspend 不再自动豁免暂停,必须用 #SuspendExempt 指令或 S 选项(比如 Hotkey "^s", SaveFunc, "S")。

二五、数据处理:函数更强大

1. Random:重做了,更好用

  • 支持 64 位整数(范围更大);
  • 不传参数返回 0.0~1.0 的浮点数(以前返回整数);
  • 传一个参数(如 Random(9))返回 0~9 的数(以前默认上限是 2147483647);
  • 用系统随机数生成器,更靠谱,不用手动 “播种”。

2. StrGet/StrPut:处理字符串编码更灵活

  • 支持 Buffer 对象(二进制数据容器),自动受 Buffer 大小限制;
  • StrPut 返回字节数,方便直接传给 Buffer() 创建对应大小的缓冲区。

3. RegExMatch:对象用法变了

  • 必须返回匹配对象(老版本的 O 选项成了默认);
  • 匹配对象的属性更清晰:match.Pos 是位置,match.Len 是长度,子匹配用 match[1] 而不是 match.Value(1)。

4. Sort:更稳定,更灵活

  • 用法变了:Output := Sort(Input, Options, Callback),输入输出分开;
  • 排序更稳定:两个元素相等时,保持原始顺序;
  • 支持 “逻辑比较”(CLogical 选项),比如按数字大小排 "10" 和 "2"(以前按字符排会把 "10" 放 "2" 前面)。

二六、系统与注册表:接口更统一

1. 注册表函数(RegRead/RegWrite 等)

  • 根键和子键合并写:比如 RegRead("HKCU\Software\MyApp", "Version"),不用分开传;
  • RegDelete 删值更明确:省略 KeyName 时删默认值,删子键用新的 RegDeleteKey;
  • RegRead 有 Default 参数:没找到时返回默认值,不抛异常。

2. Run/RunWait:错误处理变了

  • 去掉 UseErrorLevel 选项,出错抛异常(用 Try/Catch 处理);
  • RunWait 返回程序的退出代码(比如正常退出是 0)。

3. SendMessage/PostMessage:参数更严格

  • wParam 和 lParam 必须是整数或带 Ptr 属性的对象,传字符串会报错;
  • 失败或超时抛异常,返回消息回复,去掉 ErrorLevel。

二七、其他重要变化

1. 很多函数返回整数而非字符串

比如 WinExist()、ControlGetHwnd() 等,返回窗口 / 控件的句柄(整数),不再是十六进制字符串,方便直接用在 DllCall 等地方。

2. 用 1/0 替代 On/Off

比如 GetKeyState("CapsLock") 返回 1(开)或 0(关),Suspend(1) 暂停,Suspend(0) 恢复,更符合表达式逻辑。

3. #Warn:警告更有用

  • 去掉 UseUnsetLocal 等选项(因为读未定义变量会直接报错);
  • 新增 VarUnset 警告:第一次用没赋值过的变量时提醒你(默认弹窗)。

4. Exit:行为更合理

Exit 只退出当前线程,脚本等最后一个线程结束才终止,保证 Finally 代码块执行(比如释放资源)。

二八、DllCall:调用系统 / 第三方 DLL 更严格、更安全

DllCall 是用来调用系统或第三方 DLL 文件里的函数的,v2 里规则更明确,不容易出错:

1. 类型参数必须加引号

以前可能写 DllCall("user32.dll\MessageBox", UInt, 0, Str, "内容", Str, "标题", UInt, 0),现在类型名(如 UInt、Str)必须用引号括起来,否则会把变量名当类型,报错:
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

2. 字符串输出更安全,避免溢出

如果 DLL 函数要给你的字符串变量写内容(输出参数),v2 会检查字符串是否 “正常结束”(有没有二进制零),如果发现异常(比如缓冲区溢出),会直接终止程序,防止出错。
另外:
  • 普通 AStr(ANSI 字符串)现在只能 “输入”,不能 “输出”(因为缓冲区大小不够);
  • 如果 DLL 返回新的字符串地址(比如 Str* 参数),v2 会自动把新字符串赋值给你的变量,不用手动处理地址。

3. 支持传对象(带 Ptr 属性的)

以前传指针只能用整数,现在可以传带 Ptr 属性的对象(比如 Buffer、ComObject),方便处理二进制数据或 COM 对象:
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

4. 数字参数必须是数字,输出要传 “引用”

  • 如果参数是数字类型(比如 Int、UInt),传非数字(如空字符串)会报错;
  • 要接收 DLL 的输出值(比如 Int* 类型参数),必须传 “变量引用”(用 &变量名),不然收不到值:
     
     
     
    隐藏内容,支付积分后阅读
    已经有1人购买查看了此内容
    15
    15积分

     

二九、Loop 子命令:文件 / 注册表循环更简单

以前的 Loop, File、Loop, Reg 现在改了名字和参数,更直观:

1. 文件循环:Loop Files

代替旧的 Loop, FilePattern [, IncludeFolders, Recurse],现在用 Loop Files "文件路径" "模式",模式可以是:
 
  • F:只找文件;
  • D:只找文件夹;
  • R:递归找(包括子文件夹);
  • 组合:RF(递归找文件)、RD(递归找文件夹)。
 
例子:递归找 C 盘所有 .txt 文件
 
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

2. 注册表循环:Loop Reg

代替旧的 Loop, RootKey [, Key, IncludeSubkeys, Recurse],现在用 Loop Reg "注册表路径" "模式",模式和文件循环类似(R 递归)。
例子:遍历 HKCU 下的 Software 子键
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 
注意:没了 A_LoopRegSubKey,现在 A_LoopRegKey 直接包含完整路径。

三零、InputBox:输入框更灵活,返回对象

v2 的 InputBox 语法简化了,返回一个对象,包含 “用户操作结果” 和 “输入的内容”,不用再记复杂的参数顺序:

语法

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

 
  • 选项:空格分隔,比如 Password(密码框,输入隐藏)、T5(5 秒超时)、w300(宽度 300);
  • 返回对象的属性:
    • Result:OK(用户点了确定)、Cancel(取消)、Timeout(超时);
    • Value:用户输入的内容(取消 / 超时则为空)。

例子:密码输入框(5 秒超时)

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

 

三一、MsgBox:消息框更直观,返回按钮结果

v2 的 MsgBox 也简化了,支持更多直观选项,返回用户点击的按钮名称(比如 OK、Cancel):

语法

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

 
  • 选项:空格分隔,常用的有:
    • 按钮组合:OKCancel(OK + 取消)、YesNo(是 + 否)、RetryCancel(重试 + 取消);
    • 图标:Icon!(警告)、Icon?(疑问)、Iconi(信息);
    • 超时:T3(3 秒自动关闭,返回 Timeout);
    • 默认按钮:Default2(第二个按钮为默认)。

例子:带警告图标 + OK/Cancel 按钮(3 秒超时)

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

 

三二、子命令大改:主命令没了,全是单独函数

以前的 ControlGet、WinGet、DriveGet 这些 “主命令” 全被删掉了,改成了单独的小函数,比如 ControlGetChecked()、WinGetID(),更易记、更规范。

核心变化

  1. 函数名对应功能:比如 “检查控件是否勾选” 就是 ControlGetChecked(),“获取窗口句柄” 就是 WinGetID();
  2. 返回值更明确:比如 WinGetID("记事本") 直接返回窗口的句柄(整数),不是字符串;
  3. 失败抛异常:找不到窗口 / 控件时,直接报错(用 Try/Catch 处理),不再检查 ErrorLevel。

常用函数例子

功能 旧版(v1) 新版(v2) 例子
检查控件是否勾选 ControlGet, Output, Checked ControlGetChecked (控件,窗口) isChecked := ControlGetChecked("Button1", "记事本")
获取窗口句柄 WinGet, Output, ID WinGetID (窗口) hwnd := WinGetID("记事本")
获取驱动器剩余空间 DriveGet, Output, Free DriveGetSpaceFree (驱动器) freeSpace := DriveGetSpaceFree("C:")
关闭进程 Process, Close, 进程名 ProcessClose (进程名) pid := ProcessClose("notepad.exe")
获取 ListView 控件内容 ControlGet, Output, List ListViewGetContent (控件,窗口) content := ListViewGetContent("SysListView321", "文件夹")

三三、新增实用函数:解决以前的麻烦事

v2 加了很多新函数,专门解决以前需要复杂代码才能实现的功能:

1. Buffer:存二进制数据

创建一块 “内存缓冲区”,用来存字节数据(比如 DLL 返回的二进制、文件读取的字节),比变量更方便:
 
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

2. CaretGetPos:获取光标位置

准确获取文本插入点(光标)的 X/Y 坐标,避免以前 A_CaretX/A_CaretY 的缓存问题:
 
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

3. ClipboardAll:处理剪贴板所有内容

以前 ClipboardAll 是变量,现在是函数,能完整保存剪贴板的所有内容(比如图片、文件),还能恢复:
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

4. DirExist:判断文件夹是否存在

以前要靠 FileExist("文件夹\*") 间接判断,现在直接用 DirExist:
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

三四、新指令 #DllLoad:提前加载 DLL

脚本开始执行前,提前加载需要的 DLL 文件,避免后面调用时临时加载的延迟:
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

三五、内置变量:重命名、删除、更规范

v2 对内置变量做了大整理,重点是:
 
  1. 加 A_前缀:所有系统内置变量都带 A_(比如 Clipboard 改成 A_Clipboard);
  2. 返回整数:以前返回字符串的数字变量(比如 WinExist()),现在返回整数;
  3. 删除冗余:没用的变量全删了(比如 A_CaretX 用 CaretGetPos 代替)。

常用变量变化

旧版变量 新版变量 说明
Clipboard A_Clipboard 剪贴板内容
A_LoopFileFullPath A_LoopFileFullPath 循环文件的完整路径(旧版 A_LoopFileLongPath)
A_LoopFileLongPath 删掉 用 A_LoopFileFullPath 代替
A_IsCompiled A_IsCompiled 1 = 编译后,0 = 未编译(以前返回空字符串)
A_IPAddress1~4 删掉 用 SysGetIPAddresses () 函数代替
A_ExitReason 删掉 用 OnExit 回调的参数代替

三六、内置对象:File 对象更严格

操作文件的 File 对象(比如 FileOpen 创建的)现在规则更严:
  • 属性和方法不能混用:比如 FileObj.Pos 是属性(获取当前位置),不能写成 FileObj.Pos()(方法调用);
  • 参数错误直接报错:比如给只读属性赋值(如 FileObj.Pos := 100,Pos 是只读),会抛出异常;
  • File.Tell () 删掉了:用 FileObj.Pos 代替(获取当前位置)。

三七、GUI核心变化:从 “命令” 到 “对象”

先搞懂一个概念:对象就是 “装着数据和功能的盒子”。
  • 比如一个 “窗口” 是 Gui 对象,盒子里有 “显示窗口”“销毁窗口”“加按钮” 这些功能(叫 “方法”),还有 “窗口标题”“背景色” 这些信息(叫 “属性”);
  • 一个 “按钮” 是 GuiControl 对象,盒子里有 “改按钮文本”“判断是否被点击” 这些方法和属性。
 
以前用命令(比如 Gui New 创建窗口,Gui Add Button 加按钮),现在直接创建对象:
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 

三八、怎么创建 GUI 和控件?

1. 第一步:创建窗口(Gui 对象)

用 Gui() 函数创建,括号里可以传窗口标题、样式等参数:
 
隐藏内容,支付积分后阅读
已经有1人购买查看了此内容
15
15积分

 
Gui 对象常用属性(改窗口信息):
  • guiWin.Title:改窗口标题(比如 guiWin.Title := "新标题");
  • guiWin.BackColor:改窗口背景色(比如 guiWin.BackColor := "FFE4B5",浅橙色);
  • guiWin.Hwnd:获取窗口句柄(整数,用于调用系统函数)。

2. 第二步:给窗口加控件(GuiControl 对象)

用 Gui对象.Add(控件类型, 选项, 初始文本) 加控件,返回的就是 “控件对象”,可以存到变量里反复操作。
 

常见控件类型:Button(按钮)、Edit(输入框)、Text(静态文本)、ListBox(列表框)。

例子 1:加输入框和按钮

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

 

关键:控件命名与取值

  • 加控件时用 v控件名 选项(比如 vusername),后续可以通过 Gui对象["控件名"] 获取控件对象(比如 guiWin["username"]);
  • 用 Gui对象.Submit() 一次性获取所有命名控件的值,返回一个 “键值对数组”(比如 {username: "小明", password: "123"}),不用再定义全局变量存值了!

三九、事件处理:不用再判断 A_GuiEvent 了!

以前用 g-label(比如 gBtnClick)处理控件事件,还要在标签里判断 A_GuiEvent 是什么(点击、双击、选中等),现在直接给控件注册特定事件,函数只处理一种情况,更简单。

常用事件类型

控件类型 常用事件 说明
Button “Click” 按钮被点击
Edit “Change” 输入框内容改变
ListBox “Select” 列表项被选中
Gui 对象 “Close” 窗口被关闭

例子:输入框内容改变时实时显示

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

 

事件函数的参数

事件处理函数会自动收到两个参数:
  1. ctrl:触发事件的控件对象(比如按钮、输入框);
  2. info:事件的详细信息(比如点击的坐标、选中的项目索引)。
不用再查 A_Gui、A_GuiControl 这些内置变量了!

四零、常用 GUI 操作:方法和属性

以前用 Gui Show、Gui Font 这些命令,现在直接调用 Gui 对象的 “方法”(功能)和 “属性”(信息)。

1. 显示 / 隐藏 / 销毁窗口

操作 v1 命令 v2 方法 例子
显示窗口 Gui Show Gui 对象.Show () guiWin.Show("x100 y100")
隐藏窗口 Gui Hide Gui 对象.Hide () guiWin.Hide()
销毁窗口 Gui Destroy Gui 对象.Destroy () guiWin.Destroy()
窗口最大化 Gui Maximize Gui 对象.Maximize () guiWin.Maximize()

显示窗口时指定位置和大小

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

 

2. 改字体和颜色

操作 v1 命令 v2 方法 / 属性 例子
窗口字体 Gui Font Gui 对象.SetFont () guiWin.SetFont("s12 cRed")
控件字体 GuiControl Font GuiControl 对象.SetFont () btn.SetFont("b s10")
窗口背景色 Gui Color Gui 对象.BackColor guiWin.BackColor := "F0F8FF"
控件文本颜色 – GuiControl 对象.Opt () txt.Opt("cBlue")

例子:给按钮设置加粗红色字体

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

 

3. 操作控件(改文本、取值、禁用)

直接用 GuiControl 对象的属性:
操作 v1 命令 v2 属性 / 方法 例子
改按钮文本 GuiControl,, 新文本 GuiControl 对象.Text btn.Text := "已点击"
取输入框值 GuiControlGet, var GuiControl 对象.Value userInput := edit.Value
禁用按钮 GuiControl, Disable GuiControl 对象.Enabled btn.Enabled := false
隐藏控件 GuiControl, Hide GuiControl 对象.Visible edit.Visible := false

例子:禁用按钮并改文本

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

 

四一、那些被删除的功能和替代方案

v2 删了一些 v1 的旧功能,改用更简单的方式实现:
被删除的功能 替代方案
+HwndVarName(获取控件句柄) GuiControl对象.Hwnd(直接获取整数句柄)
g-label(事件标签) GuiControl对象.OnEvent()(注册事件)
控件关联变量(比如 username) Gui对象.Submit()(返回数组)
Gui Default(默认 GUI) 直接用 Gui 对象变量(比如 guiWin.Show())

四二、注意事项

  1. 没有 “默认 GUI”:必须用 Gui 对象变量操作窗口(比如 guiWin.Show()),不能像 v1 那样省略;
  2. 控件值不会自动存变量:必须用 Gui对象.Submit() 或 GuiControl对象.Value 获取值;
  3. 事件函数里用 ctrl.Gui 找窗口:比如按钮的 ctrl.Gui 就是它所属的窗口对象,不用再记窗口名;
  4. DPI 适配更好:高 DPI 屏幕下,控件尺寸和边距会自动调整,比 v1 更清晰。

四三、错误处理:从 “偷偷报错” 到 “主动抛异常”

以前靠 ErrorLevel 判断错误(比如 FileOpen 失败后 ErrorLevel=1),现在全改成 “抛异常”—— 出错时直接中断代码,必须用 Try/Catch 处理,避免错误被忽略。

1. 没了 ErrorLevel,全靠 Try/Catch

ErrorLevel 彻底删除!所有函数失败时都会 “抛异常”(比如找不到文件、窗口不存在),必须用 Try 包裹可能出错的代码,用 Catch 处理错误。

例子:打开不存在的文件

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

 

2. Catch 能精准抓特定错误,不用瞎判断

以前要抓特定错误,得在 Catch 里手动检查错误信息;现在 Catch 可以直接指定 “错误类型”,只处理目标错误,其他错误继续往上抛。
常见错误类型:
  • TimeoutError:超时(比如 SendMessage 超时);
  • TargetError:目标不存在(比如找不到窗口、控件);
  • OSError:系统错误(比如文件权限不够);
  • ValueError:值无效(比如给只读变量赋值)。

例子:只处理 “窗口超时” 错误

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

 

3. OnError:处理全局关键错误

OnError 是全局错误回调函数,现在能处理 “快退出脚本” 的关键错误(比如内存不足),还能控制是否继续运行:
 
  • 回调函数会收到第二个参数,决定行为:
    • Return:返回 -1 继续当前线程,返回 0/1 退出线程;
    • Exit:不支持继续,返回非零停止后续处理;
    • ExitApp:关键错误(比如内存溢出),返回非零仍会终止脚本。

例子:全局错误回调

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

 

4. 可继续错误:报错后能选 “不退出”

大部分错误对话框会多一个 “继续” 选项 —— 选了之后,出错的函数返回空字符串,脚本继续运行(不用强制退出)。比如调用 DllCall 传错参数,选 “继续” 后,DllCall 返回 "",脚本接着跑。

四四、表达式与函数:错误更严格,不 “默默放水”

v2 对表达式和函数的错误检测更严,以前能 “蒙混过关” 的情况,现在会直接报错:
 
以前的 “放水” 情况 现在的行为(报错)
给只读变量赋值(比如 A_ScriptName := "新名") 抛 ValueError,提示 “无法赋值给只读变量”
除以 0(比如 1/0) 抛 Error,提示 “除以零”
非数字做数学运算(比如 "abc"+1) 抛 Error,提示 “操作数不是数字”
动态调用不存在的函数(比如 fn := "不存在的函数", fn()) 抛 Error,提示 “函数未定义”

四五、热键 / 热字串:细节调整,更符合直觉

1. 删了几个不常用的键名,用新的代替

被删除的键名 替代键名 说明
Return Enter 回车键
Break Pause 暂停键

2. 热串的冒号处理更清晰

以前热串的冒号(:)分隔符规则混乱,现在统一:
 
  • 用第一对冒号当分隔符,比如 ::触发文本::替换文本;
  • 触发文本里的冒号要转义(加 \),比如 ::5\:::6 表示 “输入 5: 时替换成 6”。

例子:热串触发文本含冒号

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

 

3. 热键不随便 “屏蔽” Win/Alt 键

以前不管热键需不需要 Win/Alt 键,只要物理键按下,就会屏蔽松开事件;现在只有 “热键本身需要 Win/Alt 键”(比如 #n、!a),才会屏蔽松开,避免影响其他操作。

四六、默认设置大改:不用再写一堆 “初始化代码”

v2 优化了很多默认设置,以前要手动写的指令(比如 #NoEnv、SetBatchLines -1),现在默认就生效,省代码!
 
以前需要手动写的指令 现在的默认行为 说明
#NoEnv 默认不加载系统环境变量 避免环境变量冲突,要读环境变量用 EnvGet
SetBatchLines -1 脚本全速运行 不用再写,默认就是最快速度
SendMode Event SendMode Input 发送按键更精准,减少兼容性问题
SetTitleMatchMode 1 SetTitleMatchMode 2 窗口标题匹配 “包含”(更常用),比如 WinActivate "记事本" 能匹配 “无标题 – 记事本”
CoordMode Window CoordMode Client 坐标默认相对于窗口 “内容区”(不含标题栏),和 GUI 控件一致
脚本编码默认 ANSI 脚本编码默认 UTF-8 支持中文更友好,不用再改编码
#SingleInstance Prompt 默认提示 “是否替换已运行脚本” 不用写 #SingleInstance,默认就是提示模式
工作目录默认 “启动目录” 工作目录默认 A_ScriptDir(脚本所在文件夹) 读脚本同目录文件更方便,不用写 SetWorkingDir %A_ScriptDir%

四七、“持续运行” 规则:脚本什么时候不退出?

以前脚本只要有 OnMessage 或钩子就不退出,现在规则更明确 —— 只有满足以下条件之一,脚本才 “持续运行”,否则执行完就退出:
 
  1. 有自定义热键 / 热字串;
  2. 有可见的 GUI 窗口;
  3. 有启用的定时器(SetTimer);
  4. 有 OnClipboardChange 回调;
  5. 有激活的 InputHook(监听输入);
  6. 手动调用了 Persistent()(强制持续运行)。
 
注意:OnMessage 不再让脚本持续运行,需要手动加 Persistent() 才能保持脚本不退出。

四八、其他实用调整

1. 正则默认支持所有换行符

正则匹配换行时,默认支持 \r(回车)、\n(换行)、\r\n(Windows 换行),不用再手动加 (*ANYCRLF) 选项。

2. 脚本参数用 A_Args 代替编号数组

以前脚本命令行参数存在 1、2 这些变量里,现在统一存到 A_Args 数组里,比如运行 script.ahk 张三 20,A_Args[1] 是 “张三”,A_Args[2] 是 “20”。

3. 放弃支持老系统(XP/2000)

只支持 Windows Vista 及以上系统(Win7/8/10/11),不用再兼容老系统的 bug,功能更稳定。

四九、其他小提醒

  • 对象里不能存带二进制零的字符串当 “键”,但可以当 “值”;
  • 把对象和字符串拼接(比如 obj + "abc")会报错,以前会偷偷当空字符串,现在更严格;
  • 变量没赋值就用,会直接报错(以前可能默默给空值),可以用 IsSet(var) 先检查变量有没有值。
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

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

ahk2 函数详解(山寨版)

2025-9-30 11:02:10

教程

精准网格鼠标拖拽脚本:LabelImg 标注场景的效率神器

2025-10-2 12:27:15

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