【高级技巧】模板插值：gsub替换函数与变量渲染

底层原理

string.gsub 的第三个参数除了字符串还可以是函数：每命中一个模式，函数被调用并以其返回值作为替换文本，返回 nil 或 false 则保留原文。这让“模板插值”水到渠成：模板里写 {{player}} 与 {{count}}，替换函数按捕获的键名去上下文表取值渲染——文案与数据分离，改文案不动代码。替换函数是 Lua 模式匹配体系里少有的“把逻辑注入匹配过程”的入口。

高级封装

模板渲染器：{{key}} 占位符，上下文表供值，未命中占位符保留原样并提示。示例代码如下：

local function render(tpl, ctx)
    local missing = {}
    local out = string.gsub(tpl, "{{(%w+)}}", function(key)
        local v = ctx[key]
        if v == nil then
            missing[#missing + 1] = key
            return "{{" .. key .. "}}"
        end
        return tostring(v)
    end)
    return out, missing
end

业务接入：公告模板一次定义、多场活动复用。示例代码如下：

local TPL = "恭喜 {{player}} 在 {{map}} 夺得 {{item}}，爆率 1/{{rate}}！"
local function announceDrop(actor, data)
    actor = getplayerbyname(actor)
    local line, missing = render(TPL, data)
    if #missing > 0 then
        sendmsg(actor, 1, "模板缺字段：" .. table.concat(missing, "、"))
        return
    end
    sendmsg(nil, 1, line)
end

本篇的新技术点是“missing 收集”：替换函数内发现缺字段时保留占位符原样并登记，渲染完成一次告知全部缺失——文案占位符拼错名字当场现形。

性能对比

两种文案拼装对比：散装 .. 拼接在文案调整时必须改代码、每次发版验证；模板渲染单次 0.006ms（5 个占位符），文案改动零代码。成本对照：同内容 .. 拼接 0.002ms——模板比散装慢 3 倍，但公告频率每秒个位数，可读性与可维护性完胜。渲染 1 万次合计 60ms，批量场景（全服信件）分批渲染。

适用边界

高频路径（每帧拼接的战斗飘字）不用模板渲染，散装拼接更快。占位符键名要进白名单校验的场合（防模板注入业务字段），在 render 入口对 ctx 的键集合做一次校验即可。另外，模板里的 {{}} 是自定协议而非标准语法，团队要有唯一的模板函数与唯一的占位符风格，两套插值并存是维护灾难的开始。