<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[编译通过但设备不动作：排查清单]]></title><description><![CDATA[<p dir="auto">「编译没报错，脚本在软件里也能跑，烧进去按了没反应。」</p>
<p dir="auto">这是最多的一类问题，而且几乎都不是代码问题。按下面五条顺序查，基本能定位。</p>
<h2>第 0 步：先看状态栏第二栏</h2>
<p dir="auto">按一下触发键，看第二栏有没有<strong>变绿</strong>。</p>
<ul>
<li><strong>变绿</strong> → 宏在跑。问题在「输出打到了哪里」或「动作本身不对」，跳到第 6 条；</li>
<li><strong>不变绿</strong> → 触发没进来。继续第 1 条。</li>
</ul>
<p dir="auto">这一步能砍掉一半的排查范围，别跳过。</p>
<h2>第 1 条：设备类型选错了</h2>
<p dir="auto">宏绑定页的「设备类型」选的是<strong>插在盒子上的那个设备</strong>，不是你手上按的那个。</p>
<ul>
<li>盒子插的是鼠标，这里选「键盘」→ 不生效；</li>
<li>盒子插的是键盘，这里选「鼠标」→ 不生效。</li>
</ul>
<p dir="auto">判断依据：<strong>触发键属于哪个设备</strong>。用鼠标侧键触发，就选鼠标；用键盘某个键触发，就选键盘。</p>
<h2>第 2 条：触发键选错了</h2>
<ul>
<li>键盘支持全部 HID Usage 键。弹出列表后可以直接敲键盘快速选中——想绑哪个键就按一下它；</li>
<li>鼠标只支持五键（左、右、中、侧后、侧前）。</li>
</ul>
<p dir="auto">常见的错：想绑「侧键」，结果绑成了「中键」；想绑 <code>F5</code>，结果绑成了 <code>num5</code>（小键盘和主键盘不是同一个键）。</p>
<h2>第 3 条：触发类型不适合这个脚本</h2>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>脚本类型</th>
<th>该选</th>
</tr>
</thead>
<tbody>
<tr>
<td>一次性动作（输入文本、执行快捷键序列）</td>
<td>按下触发</td>
</tr>
<tr>
<td>持续动作（连发、按住循环）</td>
<td><strong>按下触发松开中断</strong></td>
</tr>
<tr>
<td>松开才执行的动作</td>
<td>松开触发</td>
</tr>
</tbody>
</table>
<p dir="auto">最典型的错：连发脚本 <code>while true do ... end</code> 绑了「按下触发」。这时脚本会一直跑下去，松手也不停（只能按终止键），用户会以为「卡住了」。反过来，一次性脚本绑了「按下触发松开中断」，手指一松就中断，动作只做了一半——也会被描述成「不动作」。</p>
<h2>第 4 条：场景不对</h2>
<p dir="auto">10 个场景互相独立。<strong>你在场景 1 配的宏，切到场景 3 之后完全不生效。</strong></p>
<p dir="auto">看当前是哪个场景，以及场景切换快捷键有没有被误触。这是「昨天能用今天不能用」的最高频原因。</p>
<h2>第 5 条：到底烧录成功了没</h2>
<p dir="auto">三种常见情况：</p>
<ol>
<li><strong>只编译没烧录</strong>。改完脚本 → 编译 → 就以为生效了。<strong>必须点宏绑定页的烧录</strong>，硬件里跑的是烧进去的那一版；</li>
<li><strong>烧录时设备没连好</strong>。状态栏第一栏是红的，烧录不会成功；</li>
<li><strong>烧的是另一个场景的配置</strong>。烧录是对当前场景生效的。</li>
</ol>
<p dir="auto">判断方法：改脚本里一个明显的参数（比如把连点次数从 10 改成 3），重新编译 + 烧录，看行为有没有变。没变说明烧录这一步没成功。</p>
<h2>第 6 条：状态栏绿了但没效果</h2>
<p dir="auto">说明宏在执行，但按键没打到该去的地方，或者动作本身不是你想要的。</p>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>现象</th>
<th>原因</th>
</tr>
</thead>
<tbody>
<tr>
<td>按键没反应，鼠标也没动</td>
<td>目标窗口没有焦点。宏只发按键，不切窗口</td>
</tr>
<tr>
<td>文字进去了，但全是数字 / 乱码</td>
<td><code>TypeText</code> 的小键盘被 NumLock 关掉了，或输入法在中文状态</td>
</tr>
<tr>
<td>按键变成了别的功能</td>
<td>目标软件改过快捷键；或者用了小键盘键而软件只认主键盘键</td>
</tr>
<tr>
<td>动作做了一半就停</td>
<td>延时给少了，后续动作被前一步的未完成状态吞掉</td>
</tr>
<tr>
<td>触发了两次</td>
<td>触发键被宏自己按到了（自我触发），换一个不冲突的键</td>
</tr>
</tbody>
</table>
<h2>第 7 条：终止键的问题</h2>
<p dir="auto">默认终止键是 ESC。如果你插的是小键盘或者只用鼠标，ESC 可能根本按不到——脚本跑起来之后停不下来，表现是「一直动」。</p>
<p dir="auto">去 <strong>偏好 → 宏中止按键</strong>，换一个手边有的键。<strong>写 <code>while true</code> 循环之前，这一步必须做。</strong></p>
<h2>还没解决</h2>
<p dir="auto">按这个顺序再试一遍：</p>
<ol>
<li><strong>重启软件，重新插设备</strong>。排除状态问题；</li>
<li><strong>换一个最简单的脚本</strong>（就一行 <code>KeyTap("a")</code>）烧进去试。能用 → 问题在原脚本；不能用 → 问题在设备或绑定；</li>
<li><strong>关闭自动加载宏，清空所有绑定，从头加一个宏</strong>。排除历史配置污染（见<a href="/topic/66">《设备识别、固件更新与恢复》</a>）；</li>
<li><strong>换一个 USB 口直插，不经 Hub</strong>。</li>
</ol>
<p dir="auto">到这里还不行，去发帖，把这五项写全：</p>
<pre><code>软件版本 / 固件版本：
设备类型：键盘 or 鼠标
触发键 + 触发类型：
场景编号：
脚本原文 + 编译输出：
现象：第二栏变绿吗？目标窗口是什么软件？
</code></pre>
<p dir="auto">这五项写全，问题基本一眼能看出来。只写「不能用」的帖子，谁也帮不上。</p>
]]></description><link>https://www.byteohm.com/topic/69/编译通过但设备不动作-排查清单</link><generator>RSS for Node</generator><lastBuildDate>Thu, 19 Nov 2026 05:42:36 GMT</lastBuildDate><atom:link href="https://www.byteohm.com/topic/69.rss" rel="self" type="application/rss+xml"/><pubDate>Thu, 05 Nov 2026 16:46:12 GMT</pubDate><ttl>60</ttl></channel></rss>