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