【入门夯实】数值与字符串的双重身份：引擎变量的类型归一

学员常见误区

引擎变量接口读出来的值一律是字符串形态，学员拿来直接当数字参与算术与比较："200" 加 100 报错 attempt to perform arithmetic；"60" 与数字比较时部分场景被隐式转换、部分场景按字符串比较，行为飘忽。反向的错误是拼接后的数字串又被送回数值接口，类型在一来一回中悄悄漂移。错误场景：

local red = getplayvar(actor, "HUMAN", "RedName")
if red > 100 then
    sendmsg(actor, 1, "红名值过高")
end

red 是字符串 "200" 时，5.1 里字符串与数字比较按数值语义执行，但 red 存的若是带空格的 "200 " 比较结果就会出错，且算术直接报错。

正确姿势

读入即归一：引擎变量读出先 tonumber，失败给缺省值；输出到界面或存储再 tostring。红名值判定与惩罚倍率计算统一走归一入口。示例代码如下：

local function redPenalty(actorName)
    local actor = getplayerbyname(actorName)
    local red = tonumber(getplayvar(actor, "HUMAN", "RedName")) or 0
    local rate = 100
    if red >= 200 then
        rate = 80
    elseif red >= 100 then
        rate = 90
    end
    sendmsg(actor, 1, "红名值 " .. tostring(red) .. "，爆装率倍率 " .. rate .. "%")
    return rate
end

tonumber 对 nil、空串、非数字统一返回 nil，or 0 兜住全部异常形态，后续比较与算术稳定。示例代码如下：

local n = tonumber("10", 2)

带进制参数时 "10" 按二进制解析为 2，处理开关位串时有用。

引擎验证

三步验证：RedName 变量分别存 "200"、"200 "（带尾空格）、未设置三种形态，redPenalty 都能稳定输出；把 tonumber 去掉复现算术报错；验证 tonumber("10", 2) 的返回值为 2。

举一反三

类型归一要双向做：存储前把数字统一 tostring，防止表里混进数字与字符串两种键形态——pairs 遍历时 t[10] 与 t["10"] 是两个不同的键。示例代码如下：

local t = {}
t[10] = "甲"
t["10"] = "乙"
sendmsg(nil, 1, "键数量 " .. #t .. "，t[10]=" .. tostring(t[10]))

同一张表两个 "10" 键并存，读代码的人极易踩中。类型归一还要留意字符串拼接这个隐式转换大户：10 .. "" 得到 "10"，此后再比较 "10" == 10 恒为 false，判定分支看起来对却永远不进。