跳转至内容
  • Lua 语法速查:这套脚本到底是不是 Lua

    已固定 键鼠助手5.0 脚本教学 Lua
    1
    0 赞同
    1 帖子
    14 浏览
    A
    先给结论:不是标准 Lua。 键鼠助手里的「Lua」是一个封闭的小语言——解析器只实现了一个子集,能用的命令和函数是两张写死的表(15 条命令 + 9 个函数)。它的语法长得像 Lua,是因为设计时刻意对齐了 Lua 5.3 的书写习惯;但内核、类型系统、标准库都不在。 这意味着:别拿网上任何一篇「Lua 入门教程」直接往里套。 这篇把「像什么」和「哪里不一样」分开写清楚,写完的脚本至少不会卡在编译上。 一、两套方言并存 解析器同时认两种写法: 方言 写法 用不用 Lua 风格 local x = v、if..then..elseif..else..end、while..do..end、for i=a,b,step..do..end、function f(p)..end、do..end、return、break 推荐,文档化的就是这一套 遗留 BASIC 风格 If/Then/EndIf、While/Wend、For/Next、Sub/End Sub、Dim、Goto、Rem、Call、Exit Sub 老脚本兼容用,新脚本别写 两套不能混着嵌套。看到别人的脚本里出现 EndIf,那是老资产,不是你语法错。 二、数据类型 类型 字面量 说明 integer 10、0x04、0b0100 十六进制和二进制都认,0b0100 等于 4 float 2.5、1e3 1e3 是浮点 1000,不是整数 string "a" 文档里只出现过双引号写法 boolean true / false array Array(n)、StringArray(n, len) 容量在声明时定死 nil — 见下面第 3 条差异,行为需要实测 字符串变量 StringVar(n) 固定容量的字符串 数值遵循 Lua 5.3 的整数 / 浮点双类型规则,别的地方不一定这么讲究: local half = 7 / 2 -- 3.5,/ 永远是浮点除法 local whole = 7 // 2 -- 3,向下整除 local down = -7 // 2 -- -4,注意是向下取整,不是向零 local mod = -7 % 3 -- 2,floor 取模 local rem = 7 % 3 -- 1 -7 // 2 得 -4 而不是 -3,这是最容易算错的一行。 三、与标准 Lua 的六处差异 这六条是实际写脚本时会被绊住的地方,按踩坑概率排序。 1. 数组下标从 0 开始 标准 Lua 的数组从 1 开始,这里从 0 开始。 local nums = Array(5) nums[0] = 1 -- 第一个元素 nums[1] = 2 -- 第二个 nums[2] = nums[0] + nums[1] -- 3 把从网上抄来的 for i = 1, 10 套在长度 10 的数组上,会多读一个不存在的槽位。写循环时先想清楚边界是 0..n-1 还是 1..n。 2. 没有通用 table 标准 Lua 的 {} 构造器、#t 取长度、pairs / ipairs 遍历、table.insert 这些,文档里一条都没有,按不可用处理。 能用的容器只有三种: local nums = Array(5) -- 整数数组,5 个槽 local name = StringVar(16) -- 单个字符串变量 local names = StringArray(4, 16) -- 4 个字符串,每个 16 容量是写死的,运行时不会自动扩容。循环里往 Array(5) 写第 6 个元素,结果不可预期——按越界处理。 3. math.tointeger 失败返回 0,不是 nil 文档在数据类型表里列了 nil,但在 math.tointeger 的说明里又写「无 nil 类型,转换失败返回 0」。 local i1 = math.tointeger(7.0) -- 7 local i2 = math.tointeger(1.5) -- 0(不是 nil) 两处说法不一致,写代码时按「返回 0」处理更安全:转换失败和真的等于 0 无法区分,所以别把 math.tointeger 的返回值当判断依据。确定要判整数时用 math.type(v),它返回 "integer" 或 "float"。 4. 没有字符串库 string.format、string.sub、string.find、#s 取长度,文档里都没有。字符串能做的只有拼接: local text = "键鼠" .. "助手" .. " v1.0" 需要拼接数字时注意整数会变成十进制字面,小数部分按浮点规则;要控制格式,只能靠 Log 的 printf 风格参数输出到日志里看: Log("count=%d name=%s ratio=%g", 3, "键鼠助手", 1000 * 1.5) 但 Log 是输出,不返回字符串——不能拿它拼出格式化后的文本再 TypeText 出去。需要「输入格式化文本」时,只能把定值写死或分段 TypeText。 5. 0b 二进制字面量 0b0100 = 4。标准 Lua 5.3 不支持这个写法。写键码时用 0b 更直观,但换算成十进制或十六进制也一样,看个人习惯。 6. math.random 只有双参形式 local rnd = math.random(50, 100) -- [50, 100] 闭区间随机整数 文档只给了这一种形式,没有无参和单参版本。要模拟 0/1 就用 math.random(0, 1)。 四、控制语句 local count = 0 while count < 5 do count = count + 1 if count == 1 then -- 第一次 elseif count == 3 then -- 第三次 else -- 其它 end end for i = 1, 3 do if i == 2 then -- 跳过处理 end end function add(a, b) return a + b end local sum = add(2, 3) 注释用 --,只支持单行。 break 只能跳出最内层循环;嵌套循环要跳两层,得自己加标志变量逐层判断。 五、踩坑速查 现象 大概率原因 编译报 end 相关错误 容器块没闭合;for 后面漏 do,while 后面漏 do 数组读出来是 0 或者乱值 下标从 1 开始写了,或者越界 math.tointeger 结果不对 转换失败返回 0,被当成有效值用了 想 string.format 拼文本却编译不过 没有字符串库,改用 .. 拼接 循环次数比预期多一轮 0..n-1 与 1..n 混用 Log 输出看不懂 首个参数含 %d/%s/%f 时按 printf 走,不含则按空格分隔;两种模式混用容易错位 六、不确定的行为怎么确认 这套语言的文档只覆盖了「已实现且稳定」的部分,边界行为(比如 nil 到底能不能赋值、字符串容量超了会怎样)没有成文说明。 确认方法只有一条,但很有效: local v = math.type(nil) Log("type=%s", v) 编译 → 运行 → 看输出窗口。编译器通过 + 运行输出符合预期,才算确认;只有编译通过不算。 实测出新结论欢迎发到版块里,这类帖子比任何教程都有用——文档没写的地方就是靠这样一条条补出来的。