【语法】
一、机制原理
抛个坑：模板"$(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 实战帖，语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
【游戏功能】 指南车是古代的导航黑科技：车怎么转，车上小人的手永远指着南边——齿轮抵消了车身的每一度转向。今天拆指南车的表现…
【游戏功能】 火折子是古代的手电筒：吹口气火苗窜起照亮夜路——吹一口气就能复燃的火种，是古代人随身携带的光。今天拆火折子的表…
【游戏功能】 竹竿舞是节奏与勇气的双人舞：两根竹竿按节拍开合夹击，人在竿间点脚跳——竿合之前跳出是舞，竿合才跳是夹。今天拆竹…
【游戏功能】 空竹嗡嗡的哨响是转速的听觉仪表：转得越快哨响越尖锐——空竹的转速就是它的生命值，转速归零空竹就倒。今天拆抖空竹…
【游戏功能】 拆一行代码： 连弩十矢连发的核心就这一行：每一矢都是独立的飞行体，命中后独立回调——十发十回调，每一矢都在算自…
【游戏功能】 打野位是 MOBA 的独行侠：不占线上资源、专挑野怪营地逐个清掉——打野的节奏就是全图的节奏。今天拆打野清野的…