CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
数据存储

【数据存储】数据字典:物品与职业枚举的单一来源

2026-09-21 19:14 作者:996 技术组 0 阅读 数据存储

实战应用:用在哪里

裁决之杖的 ID 是 101 还是 110?战士的职业码是 0 还是 1?散落在各处的魔法数字是维护的地狱:改一个枚举全代码库搜一遍。数据字典把枚举收进单一来源,代码读字典、配置写字典、文档查字典。

字典的定义

lua

---数据字典:枚举的单一来源
local Dict = {
    JOB = { warrior = 0, mage = 1, taoist = 2 },
    QUALITY = { white = 1, blue = 2, gold = 3 },
    SLOT = { weapon = 1, helmet = 2, armor = 3 },
}

function Dict.nameOf(group, value)
    for name, v in pairs(Dict[group]) do
        if v == value then return name end
    end
    return "unknown"
end

---业务侧的引用:不再出现裸数字
function Equip.canWear(actor, itemDef)
    local player = class(actor)
    if not player then return false end
    local job = tonumber(getplayvar(actor, 2, "Job")) or 0
    return itemDef.job == Dict.JOB.warrior and
        job == Dict.JOB.warrior
end

字典按组组织枚举:职业、品质、装备位各自一组,业务代码引用 Dict.JOB.warrior 而不是写 0——魔法数字的消亡让代码自解释。反向的查询 nameOf 把值翻译回名字,日志与告警里的可读性由字典兜底:告警说「职业 2 校验失败」没人懂,说「职业 taoist 校验失败」秒懂。字典的变更走版本管理:新增枚举值是加法安全,改值与删值必须全库的影响面评审。

字典的实施

lua

---配置装载时的字典校验
function Dict.validate(cfgTable, group, field)
    for i, row in ipairs(cfgTable) do
        local v = row[field]
        if v and not Dict.hasValue(group, v) then
            Ops.alert(("配置第 %d 行 %s 字段的 %s 不在字典")
                :format(i, field, tostring(v)))
            return false
        end
    end
    return true
end

---物品表的职业字段全量校验
function Dict.onLoad()
    Dict.validate(ITEM_TABLE, "JOB", "job")
    Dict.validate(MON_TABLE, "QUALITY", "quality")
end

字典的实施靠装载期的校验:配置表的枚举字段逐一比对字典,不在字典里的值当场告警拒绝装载——配置里写了职业 3(不存在)的事故在启动时就爆出来。字典与配置文档的生成联动:文档里的枚举说明由字典导出,两份真相合成一份。跨团队的口径统一是字典的隐性价值:客户端、服务器、运营后台共用同一份枚举的定义文件,三端的职业码口径一致,配合文档的导出,打架的事故从此绝迹。

验证与监控

字典的引用率统计:裸数字的残留扫描进代码检查,字典外的魔法数字逐个清剿;字典变更的影响面报告,每次改动的引用清单自动生成。

踩坑记录

字典曾经允许重复的值(两个名字同一个码),反向查询的歧义让翻译随机,值的唯一性约束补上。枚举的删除曾经直接删行,历史数据里的旧值失去解释,删除改为废弃标记保留映射。字典的加载曾经在配置校验之后,校验用的字典还是空的,加载顺序倒置的事故让初始化的依赖图显式化。

上线要点

字典的编辑权限收敛,新增走评审、修改走公告。字典的导出覆盖三端:客户端的常量文件、服务器的模块、后台的下拉选项同源生成。新枚举的接入清单:字典登记、配置校验、文档导出三步走全。

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

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

玩法策划暗拍竞拍

【玩法策划】秘宝暗拍:全服暗标竞拍的玩法设计

实战应用:用在哪里 明拍容易被大号威慑,普通玩家不敢出手。秘宝暗拍改为全服暗标:每周一件秘宝,玩家密价投标一次,截标前互相看…

2026-09-23 03:30 996 技术组 · 0 阅读
案例复盘误封风控

【案例复盘】误封风波:一次批量误封的申诉风暴复盘

实战应用:用在哪里 充值返利活动被风控规则误判成套利,480 个大额充值账号被批量封禁 24 小时,申诉两小时破千条。误封风…

2026-09-23 03:30 996 技术组 · 0 阅读
界面UI小队血条

【界面UI】小队血条:队友状态的紧凑排布

实战应用:用在哪里 五人小队打沃玛教主,队友的血量状态只能靠点头像逐个看,集火转火慢半拍。小队血条在屏幕侧边紧凑排布四条队友…

2026-09-23 03:30 996 技术组 · 0 阅读
前端接口好友浮窗

【前端接口】好友申请浮窗:申请消息的浮窗提醒实现

实战应用:用在哪里 好友申请藏在好友面板的角标里,玩家半天不看一眼,申请积压让社交转化掉了一半。好友申请浮窗把新申请推到屏幕…

2026-09-23 03:30 996 技术组 · 0 阅读
玩法策划矿洞租赁

【玩法策划】矿位租赁:矿洞矿位租借与分成的玩法设计

实战应用:用在哪里 矿洞产出人人有份等于人人不重视,矿位租赁把矿洞变成可经营资产:矿位按 24 小时租给个人或行会,产出归租…

2026-09-23 03:30 996 技术组 · 0 阅读
数据存储消息队列解耦

【数据存储】消息队列:解耦生产与消费的异步管道

实战应用:用在哪里 击杀 BOSS 后要同时做三件事:发奖励、记流水、刷新排行榜,全都写在 killmon 触发里互相拖累,…

2026-09-23 03:30 996 技术组 · 0 阅读