【入门夯实】gmatch的捕获组：一次拆多段的迭代写法

学员常见误区

背包物品串 "裁决之杖:3|金创药:10" 要拆成名字与数量两段，学员在 gmatch 的模式里写了两个括号捕获，却按单值接收：for name in gmatch(s, "([^:|]+):(%d+)") —— 每轮迭代返回两个值，name 只拿到名字、数量被丢掉，后面用数量时全是 nil。另一类误区是以为 gmatch 匹配不到会报错——实际它只是安静地结束迭代，空结果零提示，上游还以为拆分成功了。错误场景：

for name in string.gmatch("裁决之杖:3", "([^:]+):(%d+)") do
    sendmsg(nil, 1, name .. " x ??")
end

数量段被第二次捕获带走，name 循环体里拿不到配对的数量。

正确姿势

模式里有几个括号捕获，迭代变量就接几个，一一对应一次拆多段。物品串拆解的规范写法。示例代码如下：

local bag = "裁决之杖:3|金创药:10|祝福油:2"
local function parseBag(s)
    for name, num in string.gmatch(s, "([^:|]+):(%d+)") do
        sendmsg(nil, 1, name .. " 乘 " .. num)
    end
end

两个捕获按顺序对应 name 与 num，一条 gmatch 同时拆出两段；数字段用 %d+ 还天然过滤了空段。示例代码如下：

local function countItems(s)
    local n = 0
    for _, _ in string.gmatch(s, "([^:|]+):(%d+)") do
        n = n + 1
    end
    return n
end

countItems 返回物品种数，遍历即计数不建中间表。

引擎验证

三步验证：三件物品的串拆出 3 组名字与数量，逐条输出核对；把串里塞一段不含冒号的杂质（如 "杂质|"），gmatch 跳过它不报错也不计数——理解匹配不到即静默跳过；对照 find 加循环的写法，两种方案结果一致但 gmatch 少维护一个游标变量。

举一反三

匹配不到时迭代静默结束是把双刃剑：拆分失败不报错，空结果要靠调用方自查。思路是先 find 预校验格式再 gmatch，拆不出东西时显式告警。示例代码如下：

local function safeParse(s)
    if not string.find(s, ":") then
        sendmsg(nil, 1, "物品串格式异常：" .. s)
        return
    end
    parseBag(s)
end