变量未初始化或读取落空时值为 nil，学员以为它会一路当 0 参与计算——实际 nil 一路原样传递，直到第一处算术或比较才报 attempt to perform arithmetic on a nil value。报错行指向算术点，根因却在几层之前的读取处，学员盯着报错行排查半天找不到源头。更糟的是有人用 or 0 把异常悄悄吞掉，该有值的字段缺失时计算照跑，产出错误结果而不是报错。错误场景：
local red = getplayvar(actor, "HUMAN", "RedName")
local bonus = getplayvar(actor, "HUMAN", "RedBonus")
local total = red * 2 + bonus
RedBonus 未写入时 bonus 为 nil，加法处报错，但根因是变量缺失而非加法写错。
两个原则：入口处显式判空，让缺失在最近处暴露；确属可缺省的字段才用 or 兜底，并区分"缺省合法"与"缺失异常"。红名爆装计算的正确定义。示例代码如下：
local function calcDropRate(actorName)
local actor = getplayerbyname(actorName)
local red = getplayvar(actor, "HUMAN", "RedName")
if red == nil or red == "" then
sendmsg(actor, 1, "红名值缺失，按白名处理。")
red = 0
end
local bonus = tonumber(getplayvar(actor, "HUMAN", "RedBonus"))
if bonus == nil then
error("RedBonus 未初始化，拒绝计算爆装率")
end
local rate = 100 + tonumber(red) * 2 + bonus
sendmsg(actor, 1, "当前爆装率 " .. rate .. "%")
return rate
end
可缺省的 red 判空后兜 0，属异常的 bonus 用 error 带上下文直接抛出——报错在根因处发生，堆栈首行就是答案。示例代码如下：
local function safeDiv(a, b)
if b == 0 or b == nil then
return 0
end
return a / b
end
safeDiv 把除零与空除数都拦在函数内，调用方不必层层判空。
三步验证：RedBonus 未写入时调用 calcDropRate，error 信息带"RedBonus 未初始化"字样且堆栈指向本函数；补写 RedBonus 后计算恢复正常；把 error 行替换成 or 0 兜底，观察错误结果静默产出的风险场景。
多个可缺省字段连续参与计算时，逐个判空冗长，思路是集中归一：读齐后一次性过 tonumber 校验表，缺哪个报哪个。示例代码如下：
local function requireNums(t, keys)
for _, k in ipairs(keys) do
if tonumber(t[k]) == nil then
error("字段缺失或非数字：" .. k)
end
end
end
requireNums(cfg, {"rate", "bonus", "cap"}) 三个关键字段一次校验，报错指名道姓。
全站技术干货持续更新：996 引擎 / Lua 实战帖，语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
设计初衷 帮会活动只有攻城与聚餐两板斧：非攻城日帮会频道冷清，成员缺乏共同目标。帮会试炼场设计：帮会自有试炼场（限时挑战波次…
设计初衷 帮会资金靠少数大佬捐献：金主一走帮会资金断崖，普通成员没有参与感也不会珍惜帮会资源。帮会会费设计：成员按职位每周缴…
设计初衷 帮会扩张靠熟人拉人：增长有天花板、新人质量参差、老人不愿带新。募兵编制设计：帮会发布募兵任务包（新人完成入帮任务即…
底层原理 协程体内出错时 resume 返回 ok=false 与错误对象，但协程体若死循环则 resume 永久挂起——错…
底层原理 coroutine.resume 的实参会在协程内成为首个 yield 的返回值；coroutine.yield …
业务场景 挂摊卖药每小时断货：玩家下线前上满货，两小时后摊位空转。摊位自动补货封装：上摊时设定补货仓库（背包或帮会仓），定时…