宏编辑器里只有三个调试手段:编译、运行(验证)、Log。用好这三个,大部分问题不用猜。
编译:只查语法,不执行
工具栏第一个按钮。它做的事就一件:把脚本解析成语法树,看能不能过。
过了 → 不代表逻辑对,只代表写得出合法语句;
没过 → 输出窗口会指向出错的行。
编译阶段能发现的:括号不配对、end 少了、for 后面漏 do、用了不存在的函数名、字符串引号没闭合。
编译阶段发现不了的:变量算错、延时给少了、按键绑定错了、目标程序没响应。
常见报错与含义:
报错大意
大概率原因
意外的 end / 缺少 end
容器块(if / while / for / function)嵌套没闭合
意外的符号 xxx
用了不支持的语法,比如 elseif 写成了 else if
未知函数 xxx
函数名拼错,或者这个能力本设备不支持
字符串未闭合
引号少了一半,或者字符串里有引号没转义
验证:真执行,但是在电脑上
工具栏第二个按钮(运行Lua脚本)。它会真的执行:鼠标会动,键会按。
用途是验证流程对不对,但有三件事必须清楚:
它在电脑上跑,不是盒子。软件侧是解释执行,硬件侧是编译成字节码后在设备上跑。链路不同,时序表现可能不一样。
执行前把光标放到安全位置。它是真的在点,点在什么地方就是什么地方。
验证通过 ≠ 硬件可用。这是最常见的误判来源:软件里跑得好好的,烧进去不动。
Log:唯一能看到内部状态的东西
Log("count=%d", count)
Log("name=%s", name)
Log("hello", 1, "world") -- 没有格式符时按空格分隔
规则:首个参数含 %d / %s / %f 等格式符时按 printf 走,否则按空格分隔打印。两种模式别混用:
Log("count=%d and", count, "more") -- 容易错位,别这么写
类型要对应:%d 对整数、%s 对字符串、%g 对浮点。cost / 100 是浮点,用 %d 会打出奇怪的值。
输出在编辑器下方的输出窗口 / 状态栏第三栏,软件验证时可见。
一套实际的定位流程
脚本「有动作但结果不对」时,按这个顺序切:
第一步:缩小到最小可复现脚本。
把出问题的那一段单独剪出来,前面加上必要的初始状态,跑一遍。能复现,问题就在这段里。
第二步:二分注释。
一段 20 行的脚本,把后 10 行注释掉(--),跑。看前半段是不是对的。对 → 问题在后半段;不对 → 问题在前半段。重复三次就能锁定到 2–3 行。
第三步:在关键位置插 Log 看状态。
local count = 0
while count < 5 do
Log("loop start count=%d", count)
MouseClick(1)
Delay(50)
count = count + 1
Log("loop end count=%d", count)
end
如果 Log 打出来的次数不对,问题在循环条件;如果次数对但动作不对,问题在循环体。
第四步:区分「代码问题」和「环境问题」。
在脚本里加一行固定的动作,比如开头先 KeyTap("a"):
如果连这个固定动作都没执行 → 代码根本没跑起来(触发方式、场景、烧录);
如果这个动作执行了,后面的没有 → 代码问题或者延时不够。
几个反复出现的坑
Log 打不出东西。 先确认是在软件里验证,不是在硬件上跑。硬件端没有输出窗口。
脚本执行到一半停了。 检查是不是按了终止键(默认 ESC),或者中途触发了别的宏。也可能是目标程序弹了模态窗口把输入吞了。
同样的脚本,今天能跑明天不能。 检查场景是不是被切走了;或者绑定的触发键被别的软件占用了。
改了脚本但行为没变。 改完要重新编译、重新烧录。只编译不烧录,硬件里跑的还是旧版本——这是最高频的「明明改了却没生效」。