【Lua实战】字符串查找与聊天命令：find 的 plain 与模式

实战应用：用在哪里

聊天框是玩家与服务器之间的命令行：@行会频道的切换、GM 的后台指令、交易行的快速挂单，命令的解析全靠字符串查找。string.find 的 plain 参数与模式匹配的取舍，决定命令解析的效率与准确。

命令的解析

---聊天命令的解析：@ 开头为指令
function Chat.parse(actor, text)
    if text:sub(1, 1) ~= "@" then
        return Chat.broadcast(actor, text)
    end
    local cmd, rest = text:match("^@(%a+)%s*(.*)$")
    if cmd == "帮" then
        return Chat.sendGuild(actor, rest)
    elseif cmd == "私" then
        local to, msg = rest:match("^(%S+)%s+(.+)$")
        return Chat.sendPrivate(actor, to, msg)
    end
    sendmsg(getplayerbyname(actor), 1, "未知指令：" .. cmd)
end

命令解析的三段式：前缀识别（@ 开头）、指令提取（字母段）、参数拆分（空白分隔）。^(%a+)%s(.)$ 的模式一次取出指令与剩余参数，私聊的收件人与消息用两个捕获组切开。玩家名与消息内容的匹配全部走 plain 查找（find 的第三参数 true），名字里的括号与点号不再被当成模式字符——玩家的名字什么都可能起，plain 是聊天解析的安全档。

匹配的取舍

---plain 与模式的性能差异
local t0 = os.clock()
for i = 1, 100000 do
    text:find("裁决之杖", 1, true)      -- plain 纯文本
end
local t1 = os.clock()
for i = 1, 100000 do
    text:find("裁决之杖")                -- 模式编译
end
local t2 = os.clock()
print(("plain %.0fms  pattern %.0fms")
    :format((t1 - t0) * 1000, (t2 - t1) * 1000))

---敏感词的快速筛查：先 plain 后精确
local function mayHit(word, text)
    return text:find(word, 1, true) ~= nil
end

十万次查找的实测：plain 版本约 40 毫秒，模式版本约 90 毫秒——模式引擎每次要编译匹配串，纯文本查找快出一倍。聊天的高频筛查（每条消息过一遍敏感词）用 plain 做粗筛，命中后再走精确的判定，两层过滤让性能与准确各得其所。命令的大小写归一化：GM 指令统一小写比较（lower 后匹配），玩家输入 GM 与 gm 都能到达同一个处理器。命令的容错给玩家留余地：多余空白的裁剪、全角符号的归一，输入的脏不影响指令的到达。

验证与监控

命令解析的单测覆盖：标准命令、缺参数、多参数、特殊字符名字、空消息五类边界；未知指令的统计，高频的未知命令提示需要新增指令或引导。

踩坑记录

玩家名字带圆括号，模式匹配的名字比较永远失败，plain 参数救场。私聊的参数拆分曾经按第一个空格切，名字带空格的服务器直接废掉该功能，改用名字优先的最长匹配。全角感叹号的命令没人识别得了，输入的归一化（全角转半角）前置到解析入口。

上线要点

聊天命令的清单进帮助系统，@指令的用法玩家随手可查。解析的入口做统一的输入清洗：裁剪、归一、长度截断三步走。指令的执行频控在解析层兜底，刷屏的命令在到达业务前被限速。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。