【进阶实战】道具描述模板：参数化文案的生成封装

业务场景

道具描述全靠手写：同一件装备在商店、掉落公告、图鉴三处描述各不相同；数值改动后文案忘了同步，"攻击 +37"的道具描述还写着 +35。描述模板封装：模板串加数值参数，一处改数值三处同步——文案与数值永不脱节。

核心实现

模板与组装。示例代码如下：

local TEMPLATES = {
    weapon = "攻击 +%d，耐久 %d/%d，暴率 1/%d",
    potion = "恢复 %d 点生命，冷却 %d 秒"
}
local function describe(item)
    local tpl = TEMPLATES[item.kind]
    if not tpl then
        return item.name
    end
    return string.format(tpl, unpack(item.params))
end
local sword = { kind = "weapon", name = "裁决之杖",
    params = { 37, 200, 320, 5000 } }
print(describe(sword))

输出"攻击 +37，耐久 200/320，暴率 1/5000"——数值与文案一次组装成型。
上架校验。示例代码如下：

local PARAM_COUNT = { weapon = 4, potion = 2 }
local function checkTemplate(kind, params)
    return PARAM_COUNT[kind] == #params
end
print(checkTemplate("weapon", { 37, 200, 320, 5000 }))

输出 true——参数个数与模板声明对齐才允许上架，缺参错位在源头拦住。

接口拆解

TEMPLATES 按道具种类存模板串（%d 占位），describe 用 string.format 配 unpack 把 params 展开填入——改模板或改参数，所有引用点自动同步。PARAM_COUNT 声明每种模板需要的参数个数，checkTemplate 在上架前校验对齐，防"少一个参数全串错位"的经典事故——错位不报错但语义全错，只能靠源头校验。

踩坑记录

道具描述踩过三个坑：一是模板串里出现百分号字面量（"成功率100%"）被 format 当占位符吃掉直接报错，字面百分号必须写 %%；二是参数顺序靠记忆，两个数字调换不报错但语义全错（耐久与暴率互换），治理方案是参数改键值表配命名占位，从根上消灭顺序依赖；三是同一道具的多语言模板参数个数不一致，定为多语言共用同一 params 数组、各语言模板自行声明参数——参数集唯一，文案多态。