【入门夯实】string.find的纯文本查找：plain参数关闭模式匹配

学员常见误区

string.find 的第二参数是模式而非普通文本：方括号、点号、百分号都是魔法字符，查找文件名、玩家名这类含特殊字符的字面文本时会匹配出错。学员逐个用百分号转义魔法字符，写出一长串可读性极差的模式串。错误场景：

local path = "map[1].txt"
print(string.find(path, "[1]"))

"[1]" 被解释为字符类（匹配字符 1），返回位置 5——想找字面的 "[1]" 三个字符，结果只匹配到了一个 1。

正确姿势

string.find 的第四参数 plain 设为 true 即关闭模式匹配，按字面查找，魔法字符一律当作普通字符。规范写法。示例代码如下：

local path = "map[1].txt"
print(string.find(path, "[1]", 1, true))
print(string.find(path, "[1]"))

纯文本版返回 4 与 6（字面 "[1]" 的起止位置），模式版返回 5 与 5（字符 1 的位置）——同一串数据两种解读，位置截然不同。

引擎验证

三步验证：plain=true 时返回值是字面子串的起止字节位置；不带 plain 时按模式规则解释；查找不含魔法字符的普通文本（如 "map"）时两者结果一致——差异只在存在魔法字符时显现。

举一反三

plain=true 最适合处理来源不可控的文本（玩家输入、聊天关键字），输入里带任何魔法字符都不出错。示例代码如下：

local function safeContains(hay, needle)
    return string.find(hay, needle, 1, true) ~= nil
end
print(safeContains("map[1].txt", "[1]"))

配套记忆：string.gsub 同样受模式规则约束，替换字面文本时也要注意魔法字符的转义或改写。