先给结论:不是标准 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)
编译 → 运行 → 看输出窗口。编译器通过 + 运行输出符合预期,才算确认;只有编译通过不算。
实测出新结论欢迎发到版块里,这类帖子比任何教程都有用——文档没写的地方就是靠这样一条条补出来的。