【前端接口】SL:Split 与 JsonDecode：前端数据处理的工具函数对

实战应用：用在哪里

前端拿到的大量数据是"字符串形态"的：服务端 sendluamsg 的字符串参数、配置表的行文本、本地缓存的内容。SL:Split 负责拆字符串，SL:JsonDecode 负责解 JSON，这对工具函数是前端数据处理的第一道工序。

字符串拆分

---字符串拆分 input:原文 delimiter:分隔符
function SL:Split(input, delimiter) end

-- 服务端推送的活动配置串："沃玛教主|20:00|双倍"
SL:RegisterLuaNetMsg(7300, function(p1, p2, p3, sMsg)
    local parts = SL:Split(sMsg, "|")
    local bossName, refreshAt, buffTag = parts[1], parts[2], parts[3]
    SL:ShowSystemTips(bossName .. " 将于 " .. refreshAt .. " 刷新")
end)

Split 返回拆好的数组表，管道符分隔的活动配置串三刀拆成三段。拆分的分隔符按数据协议约定：推送串用竖线、配置行用制表符、多级结构用组合分隔符。拆分后的元素是字符串，数值的运算前要做 tonumber 的转换，字符串与数值的类型纪律在前端的数据处理里同样重要。

JSON 的编解码

---JSON 解码 jsonStr:JSON文本 ischeck:是否校验
function SL:JsonDecode(jsonStr, ischeck) end
---JSON 编码
function SL:JsonEncode(jsonData, ischeck) end

-- 复杂奖励结构的解析
SL:RegisterLuaNetMsg(7301, function(p1, p2, p3, sMsg)
    local rewards = SL:JsonDecode(sMsg, true)
    for _, r in ipairs(rewards) do
        SL:ShowSystemTips("获得 " .. r.name .. " x" .. r.count)
    end
end)

结构化的数据用 JSON 通道：奖励列表、活动配置、行会信息这类多层结构直接 JsonDecode 成 Lua 表，扁平的简单串用 Split。编码方向（JsonEncode）用于前端向后端回传结构化数据或本地缓存的结构化存档。两个函数的 ischeck 参数开启动前校验，非法 JSON 的解析失败不再静默。

验证与监控

前端解析失败的异常上报集中监控，解析失败的样本回传用于数据协议的兼容性修复。

踩坑记录

JSON 的键大小写在前后端不一致曾经让字段读成空，协议字段的命名规范（全小写下划线）是前后端的共同约定。Split 的分隔符出现在内容里（名字里带竖线）曾经拆出残缺数据，分隔符的选型要避开业务数据可能包含的字符。

上线要点

数据协议的版本兼容：旧版本客户端收到新版本的数据结构时解析要容错，字段缺失的默认值兜底是协议演进的安全网。解析的性能在大数据量（千条配置）时做分批与缓存，解析一次反复使用而不是反复解析。工具函数的封装层：Split 与 JsonDecode 的直接调用收敛到数据处理模块，协议变更时的修改面才可控。

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