【入门夯实】字符串格式化的常见错误：%d类型与%s空值

学员常见误区

string.format 的占位符对类型有硬性要求，学员直接把变量塞进 %d：format("%d", "8542") 在 Lua 5.1 里报 bad argument（%d 只收数字，不收数字字符串）；%s 配上 nil 输出不了还中断整条消息；想保留两位小数写成 %d，小数被直接截断。错误场景：

local dmg = "8542"
local text = string.format("烈火剑法造成%d点伤害", dmg)

运行时报错，飘字函数整体中断。

正确姿势

先归一类型再格式化：数字字符串过 tonumber，可能为 nil 的字段过 tostring。战斗飘字模板按此写法可长期复用。示例代码如下：

local function dmgText(name, dmg, crit)
    dmg = tonumber(dmg) or 0
    crit = tostring(crit or false)
    local tag = crit == "true" and "暴击" or "命中"
    return string.format("%s使用烈火剑法，%s伤害%.0f，暴击率250%%", name, tag, dmg)
end

两点说明：%.0f 输出整数样式的浮点（8542.0 变 8542）；字面百分号必须写成 %%，单个 % 会被当占位符解析。示例代码如下：

local line = string.format("%s:%05d", "攻城单号", 42)

%05d 把 42 补成 00042，适合生成固定位数的流水号。

引擎验证

三步验证：dmg 传 "8542" 字符串时飘字正常输出且无报错；dmg 传 nil 时输出 0 而不是中断；把 %% 改成单个 % 观察报错，体会转义规则。

举一反三

中文名字与 %10s 这类宽度占位配合时对不齐：宽度按字节算，一个汉字占 3 字节，列对齐要按字节宽度补空格或改用 tab 分隔。示例代码如下：

local rows = { {"裁决之杖", 5000}, {"药水", 200} }
for _, r in ipairs(rows) do
    sendmsg(nil, 1, string.format("%s\t%d金币", r[1], r[2]))
end