【语法】
一、机制原理
抛个坑：模板"$(name)，您的$(item)已到账"这种带命名槽位的文案怎么填值？string.format 的占位按顺序排，槽位一多一少就整体错位。命名槽位换个思路：模板里用 $(名称) 标槽，替换时 gsub 配捕获抓出槽位名，到值表里查串填入；缺槽的键替换为空串或原样保留，便于排查漏配。槽位与值按名字对号，不依赖出现顺序。
二、错误写法
-- 错误：按顺序 format 塞值，槽位一多就错位
string.format("%s，您的%s已到账", item, name)
三、正确写法
local function fill(tpl, values)
return (tpl:gsub("%$%((%w+)%)", function(k)
return values[k] or ""
end))
end
local label = panel:getChildByName("mailText")
label:setString(fill("$(name)，您的$(item)已到账",
{name = "侠客", item = "礼包"}))
四、引擎验证
姓名与物品两个槽位按名对号填入，交换值表键序结果不变；缺槽填空不报错。
五、FAQ
问：缺槽怎么处理？
答：查不到的槽填空串，保留键名便于排查亦可。
问：槽位名有限制吗？
答：示例限字母数字，扩展可调捕获模式。
全站技术干货持续更新：996 引擎 / Lua 实战帖，语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
【游戏功能】 一、一次裸眼抓哑巴的潜行 烟幕弹玩法首版测试，玩家丢完烟幕就站在烟里发呆，怪在烟边上转圈也不进来——表现对了，…
【游戏功能】 一、一个震了个寂寞的大招 跺地震波类技能首版，特效华丽、震屏到位，测试却打回："这大招怎么只炸了一下就没了？"…
【游戏功能】 一、一个卡进墙里的箱子 推箱谜题移植首版，测试发现一个无解局面：箱子被推到墙角，四个方向都推不动，谜题卡死只能…
【游戏功能】 一、一个永远差一口气的接线 星轨接电类旋转解谜首版，测试卡在第三关：四段线路怎么转都差一口气，明明视觉上头尾相…
【游戏功能】 一、一个被风卷走的判空 龙卷风聚怪技能首测，最灵异的 bug：怪被吸到风眼附近后集体"抽搐"——坐标每帧在风眼…
【游戏功能】 一、一个只闪不中的斩击 斩钢闪类突进斩首版被吐槽"人过去了刀没过去"——突进的位移做了，斩击的刀痕却只在终点画…