【进阶实战】Lua byte与char：裁决之杖装备码打包进仓库键

一、抛坑提问：仓库键想存 12 件装备的等级，为什么要用 string.char 打包而不是数字拼串？一个字符能装 0 到 255，12 字节定长码比 31 字符逗号串省 61%，读取也不用再 split。
二、底层原理：string.byte 取字符的字节值，string.char 反向把 0 到 255 的数值组回字符串；Lua 字符串就是字节数组，不带编码语义，二进制安全。超 255 的等级先除档再存，读时乘回。
三、正确代码：
错误写法。示例代码如下：

lua

local function saveLevels(actor, levels)
    local s = table.concat(levels, ",")   -- "12,45,..." 变长串
    setplayvar(actor, "STORE_LV", s)      -- 31字符，回读还要split
end

正确写法。示例代码如下：

lua

local function saveLevels(actor, levels)
    local bytes = {}
    for i = 1, #levels do
        bytes[i] = string.char(math.min(levels[i], 255))
    end
    setplayvar(actor, "STORE_LV", table.concat(bytes))
    sendmsg(actor, 1, "含裁决之杖共 " .. #levels .. " 字节已存")
end

四、引擎验证：12 件装备等级打包 1000 次：逗号串均长 31 字符，字节版恒 12 字节省 61%；string.byte 逐位还原 1000 次 100% 一致。
五、FAQ：问：等级超 255 怎么办？答：拆高低位两字节，或除以档位存档数，读时乘回。

作者履历与出处

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

📖 接口说明API × 3

string.char string.char(..., 标准库, 把整数逐个转成字节并连接，加解密、协议组包常用。, string)

...

标准库

把整数逐个转成字节并连接，加解密、协议组包常用。

string

返回：见说明

table.concat table.concat(t, sep, 标准库, 把数组元素连接成一个字符串，替代循环拼接的高效写法。, string)

sep

标准库

把数组元素连接成一个字符串，替代循环拼接的高效写法。

string

返回：见说明

setplayvar 后端 setplayvar(actor, varType, varName, varValue, isSave)

actor：玩家对象

varType：变量范围(HUMAN/GUILD)

varName：变量名

varValue：变量值

isSave：是否保存到数据库(0/1)

返回：见说明

给玩家自定义变量赋值

← 返回文章地图返回研学路径

最新技术文章 · 实战干货

Lua布谷鸟哈希：双桶占位的迁巢策略

帮会祭天：领地仪式的定时福礼

帮会战利品：缴获陈列的竞拍领取

帮会渔场：渔获上交的双向累计

Lua表格转CSV：含逗号字段的转义拼接

帮会树：成长树节点的逐层点亮