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