按出现阶段分四类:编译期、运行期、设备连接、软件崩溃。每类给现象、原因、处理。
一、编译期
编译只查语法,所以这一类的报错都指向「写法不合法」。
报错大意
原因
处理
意外符号 end / 缺少 end
容器块没闭合
数一下 if/while/for/function 各开了几个、end 有几个
未知函数 xxx
函数名拼错,或这个能力不存在
对着《内置函数与 HID 键码对照表》核名字。注意大小写:KeyDown 不是 keydown
参数数量不对
传多了或传少了
Delay 只要一个数;MoveMouse 要两个
字符串未闭合
引号少了一半
中文引号和英文引号不是一回事,必须用英文 "
期待 then
if 后面漏了 then
if x > 1 then
期待 do
while / for 后面漏了 do
while x < 5 do
无法解析的表达式
用了不支持的语法
常见:else if(应为 elseif)、!=(应为 ~=)、++(不存在)
一个高频错误:把 = 和 == 搞混。
if count = 5 then -- 错,= 是赋值
if count == 5 then -- 对,== 是比较
还有 ~= 是「不等于」,不是 !=。
二、运行期
这类不报错,只是行为不对。
现象
原因
处理
循环次数比预期多一轮 / 少一轮
数组下标从 0 开始,与标准 Lua 不同
检查 for i = 1, n 到底该到 n 还是 n-1
math.tointeger 结果总是 0
转换失败返回 0(不是 nil),看起来像「值就是 0」
用 math.type() 判类型
数值算出来差 1
// 是向下取整,负数时与直觉不同
-7 // 2 是 -4,不是 -3
拼接字符串编不过
没有字符串库
只能用 ..,没有 string.format
Log 输出错位
格式符与参数不匹配,或两种模式混用
首个参数有 %d/%s 就全按 printf 给
脚本跑到一半停了
按了终止键 / 触发了别的宏 / 目标程序弹了模态窗
见《编译通过但设备不动作》第 6、7 条
三、设备连接与加载
现象
原因
处理
一插设备软件就卡 / 加载超时
「自动加载宏」一次读入太多宏
拔设备 → 关自动加载 → 插回 → 烧录 → 清空所有绑定
状态栏第一栏一直是红的
线、口、Hub
换线、换口、直插
烧录后行为没变
只编译没烧录;或烧的不是当前场景
改一个明显参数重烧验证
软件里能连、系统里不认
USB ID 被改过
见《USB 协议自定义》
无线设备完全收不到输入
接收器没配对
见《无线接收器重绑与格式化》
四、软件崩溃
文档里点名的场景只有一个:自动加载宏 + 宏数量过多,表现为启动时崩溃或加载极慢。
处置流程(照文档原文的顺序):
拔掉设备;
打开软件,把「自动加载宏」取消勾选;
插入设备;
点击烧录;
清空所有绑定的宏。
这套流程能恢复到干净状态。恢复后如果还崩,就不是宏数量的问题了,看下一节。
五、报错信息怎么贴
发帖求助时,不要只截一张报错图。需要三样:
报错原文(可以复制文字,比截图好);
出错的那一段脚本,不是全部;
出错时代码在第几行(编译器一般会给行号)。
如果报错是「运行时才出现」(编译能过、运行崩),加上:触发方式、场景、目标软件、以及能不能用最小脚本复现。
最小复现脚本是排查里最有价值的东西——把问题从 200 行缩到 3 行,往往自己就看出原因了。
一个通用的降错顺序
写新脚本时按这个顺序推进,比写完一起调要快:
先写一行,编译 + 运行,确认环境通;
加第一段动作,跑,确认这一段对;
套循环,次数设成 2,跑;
次数改大,跑;
加条件,跑;
最后才烧进硬件。
每一步都只改一个变量。这样出问题时,原因一定是「刚改的那一处」。