Lua+string.gsub函数替换：回调函数做替换的本质

【语法算法】

gsub 的函数替换就这一行：

str:gsub("%a", function(w) return w:upper() end)

gsub 的第二个参数可以是函数——每次匹配到就调用函数——函数的返回值替换匹配内容——gsub 函数替换的全部机制就这一行。可这一行的前后各有一个细节：前面是"gsub 的第三个参数限制替换次数"，后面是"函数返回 nil 或 false 时不替换"。今天拆开。

一、匹配、回调、替换三段

gsub 函数替换的三段。匹配：gsub 按模式从左到右扫描字符串——每找到一个匹配就调用回调函数。回调：回调函数接收匹配的内容作为参数——函数的返回值就是替换的内容——回调里可以做任意处理——大小写转换、格式化、加密解密。替换：回调返回 nil 或 false 时匹配内容保持原样——不替换——这个"跳过"的机制让 gsub 可以有条件地替换。三段连起来：gsub 函数替换玩的是"逐个匹配逐个决策"——每个匹配独立判断是否替换以及替换成什么。

graph TD
    A["str:gsub(pattern, func)"] --> B["扫描找匹配"]
    B --> C{"找到匹配?"}
    C -->|是| D["调用func(match)"]
    D --> E{"返回值非nil?"}
    E -->|是| F["用返回值替换"]
    E -->|否| G["保持原样"]
    C -->|否| H["扫描结束"]

二、函数替换的正确写法

local str = "hello WORLD foo BAR"
local result = str:gsub("%a+", function(w)
    if #w > 3 then
        return w:upper()
    end
    return nil                        -- 短词不替换
end)
print(result)

-- 用函数替换做模板引擎
local template = "你好，{name}！你的等级是{level}。"
local vars = { name = "勇者", level = 42 }
local result2 = template:gsub("{(%w+)}", function(key)
    return tostring(vars[key] or "{" .. key .. "}")
end)
print(result2)

{(%w+)} 提取模板变量名——回调里查表取值——查不到返回 nil 保留原始占位符——这就是一个最小化的模板引擎。

三、回调的纪律与捕获的联动

回调函数的纪律只有一条：不要在回调里修改被扫描的字符串——gsub 扫描的是原始字符串的副本——修改原字符串不会影响扫描但会引入副作用——回调应该是纯函数。和捕获组的联动也值得记：模式里的捕获组内容会作为参数传给回调——{(%w+)} 的捕获组是变量名——回调接收的参数就是捕获组的内容——捕获组让回调知道"匹配的是什么"而不只是"匹配到了"。最后一条纪律：gsub 的第四个参数限制替换次数——str:gsub(pat, rep, 3) 最多替换三次——次数限制可以防止全局替换过于激进——特别是处理用户输入时限制替换次数是一种安全策略。