「编译没报错,脚本在软件里也能跑,烧进去按了没反应。」
这是最多的一类问题,而且几乎都不是代码问题。按下面五条顺序查,基本能定位。
第 0 步:先看状态栏第二栏
按一下触发键,看第二栏有没有变绿。
变绿 → 宏在跑。问题在「输出打到了哪里」或「动作本身不对」,跳到第 6 条;
不变绿 → 触发没进来。继续第 1 条。
这一步能砍掉一半的排查范围,别跳过。
第 1 条:设备类型选错了
宏绑定页的「设备类型」选的是插在盒子上的那个设备,不是你手上按的那个。
盒子插的是鼠标,这里选「键盘」→ 不生效;
盒子插的是键盘,这里选「鼠标」→ 不生效。
判断依据:触发键属于哪个设备。用鼠标侧键触发,就选鼠标;用键盘某个键触发,就选键盘。
第 2 条:触发键选错了
键盘支持全部 HID Usage 键。弹出列表后可以直接敲键盘快速选中——想绑哪个键就按一下它;
鼠标只支持五键(左、右、中、侧后、侧前)。
常见的错:想绑「侧键」,结果绑成了「中键」;想绑 F5,结果绑成了 num5(小键盘和主键盘不是同一个键)。
第 3 条:触发类型不适合这个脚本
脚本类型
该选
一次性动作(输入文本、执行快捷键序列)
按下触发
持续动作(连发、按住循环)
按下触发松开中断
松开才执行的动作
松开触发
最典型的错:连发脚本 while true do ... end 绑了「按下触发」。这时脚本会一直跑下去,松手也不停(只能按终止键),用户会以为「卡住了」。反过来,一次性脚本绑了「按下触发松开中断」,手指一松就中断,动作只做了一半——也会被描述成「不动作」。
第 4 条:场景不对
10 个场景互相独立。你在场景 1 配的宏,切到场景 3 之后完全不生效。
看当前是哪个场景,以及场景切换快捷键有没有被误触。这是「昨天能用今天不能用」的最高频原因。
第 5 条:到底烧录成功了没
三种常见情况:
只编译没烧录。改完脚本 → 编译 → 就以为生效了。必须点宏绑定页的烧录,硬件里跑的是烧进去的那一版;
烧录时设备没连好。状态栏第一栏是红的,烧录不会成功;
烧的是另一个场景的配置。烧录是对当前场景生效的。
判断方法:改脚本里一个明显的参数(比如把连点次数从 10 改成 3),重新编译 + 烧录,看行为有没有变。没变说明烧录这一步没成功。
第 6 条:状态栏绿了但没效果
说明宏在执行,但按键没打到该去的地方,或者动作本身不是你想要的。
现象
原因
按键没反应,鼠标也没动
目标窗口没有焦点。宏只发按键,不切窗口
文字进去了,但全是数字 / 乱码
TypeText 的小键盘被 NumLock 关掉了,或输入法在中文状态
按键变成了别的功能
目标软件改过快捷键;或者用了小键盘键而软件只认主键盘键
动作做了一半就停
延时给少了,后续动作被前一步的未完成状态吞掉
触发了两次
触发键被宏自己按到了(自我触发),换一个不冲突的键
第 7 条:终止键的问题
默认终止键是 ESC。如果你插的是小键盘或者只用鼠标,ESC 可能根本按不到——脚本跑起来之后停不下来,表现是「一直动」。
去 偏好 → 宏中止按键,换一个手边有的键。写 while true 循环之前,这一步必须做。
还没解决
按这个顺序再试一遍:
重启软件,重新插设备。排除状态问题;
换一个最简单的脚本(就一行 KeyTap("a"))烧进去试。能用 → 问题在原脚本;不能用 → 问题在设备或绑定;
关闭自动加载宏,清空所有绑定,从头加一个宏。排除历史配置污染(见《设备识别、固件更新与恢复》);
换一个 USB 口直插,不经 Hub。
到这里还不行,去发帖,把这五项写全:
软件版本 / 固件版本:
设备类型:键盘 or 鼠标
触发键 + 触发类型:
场景编号:
脚本原文 + 编译输出:
现象:第二栏变绿吗?目标窗口是什么软件?
这五项写全,问题基本一眼能看出来。只写「不能用」的帖子,谁也帮不上。