CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
高级技巧996引擎死代码清理引用扫描

【高级技巧】脚本瘦身:未使用函数的定期清理

2026-09-25 00:15 作者:996 技术组 996引擎Lua教程传奇脚本高级技巧996引擎Lua死代码清理引用扫描

底层原理

三年迭代的脚本库里躺着大量死函数:下线功能没删干净、复制粘贴的变体无人调用、迭代残留的旧版本。每个函数在 Lua 里都是独立的函数原型对象(F:\底层文件 的 Proto 结构:指令数组加常量表独立分配),死函数占内存、拖慢加载,更大的危害是干扰维护——热更改了一个从未被调用的函数,改完"验证生效"其实线上跑的根本不是它。发现死函数的可行手段是引用扫描:从全局表与已知注册表出发,统计每个函数被引用的路径数,零引用者进入下线候选。

高级封装

引用扫描器与清理流程:遍历全局表标记函数引用路径。示例代码如下:

lua
local refMap = {}
local function scanRefs()
    local seen = {}
    local function walk(t, path, depth)
        if depth > 5 or seen[t] then
            return
        end
        seen[t] = true
        for k, v in pairs(t) do
            if type(v) == "function" then
                refMap[path .. "." .. tostring(k)] =
                    (refMap[path .. "." .. tostring(k)] or 0) + 1
            elseif type(v) == "table" then
                walk(v, path .. "." .. tostring(k), depth + 1)
            end
        end
    end
    for k, v in pairs(_G) do
        if type(v) == "function" then
            refMap[tostring(k)] = (refMap[tostring(k)] or 0) + 1
        elseif type(v) == "table" then
            walk(v, tostring(k), 1)
        end
    end
end
local function reportDead(candidates)
    for _, name in ipairs(candidates) do
        if refMap[name] == nil then
            print("死函数候选:" .. name)
        end
    end
end

清理执行对照示例代码如下:

lua
reportDead({ "oldFireCalc", "legacyEscort", "testTmp" })

报告列出三个候选,人工确认后从源码删除并走正常热更。

性能对比

一次全库扫描(约 900 个全局符号、4200 张表)耗时约 600 毫秒,只能在诊断机或维护窗口跑。清理收益:删掉 180 个死函数后,脚本库内存下降约 1.2MB,启动加载时间从 850 毫秒降到 790 毫秒;更实际的是热更排错效率——改动目标里"幽灵函数"(改了不生效的)占比从三成降到零,平均排错时间缩短近一半。扫描报告本身只读不改,删除动作始终走人工确认加正常发布流程。

适用边界

三个不适用场景:一是引擎按约定反射调用的触发入口(ontimer12 这类命名函数)不经过全局引用扫描能覆盖的路径,零引用报告会误杀它们,触发入口名单要人工排除;二是灰度下线的功能(还可能回滚开启)不删只标记,保留一个版本观察期再进清理名单;三是扫描层数超过 5 层的深层表里的引用会漏报,深层挂载的函数要先人工梳理挂载点再跑扫描。

作者履历与出处

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

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

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

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

高级技巧996引擎

【高级技巧】Lua常量提升:祖玛教主掉落表别在函数里重建

一、一行代码拆解:local function roll() 里写 local cfg = {500, 200, 50} —…

2026-09-26 05:50 996 技术组
进阶实战996引擎

【进阶实战】Lua数值精度上限:沙巴克国库囤金的2^53错账

一、隐蔽陷阱:国库金币累加到 2^53(约 9007199254740992)之后再加 1,数值纹丝不动——双精度浮点在该区…

2026-09-26 05:50 996 技术组
策划架构996引擎

【策划架构】Lua模块表单例:裁决之杖仓库的单一入口封装

一、线上事故:仓库存取逻辑散在 6 个脚本,各自写各自的 getsysvar 键名,某次改名漏改 2 处,300 件裁决之杖…

2026-09-26 05:50 996 技术组
策划架构996引擎

【策划架构】Lua分页切片:沙巴克战备仓库500件的翻页设计

一、抛坑提问:500 件战备装备一次下发必卡,按每页 20 件切片,边界怎么算才不出空页和重页?起点 (page-1) 20…

2026-09-26 05:50 996 技术组
进阶实战996引擎

【进阶实战】Lua error层级参数:烈火剑法报错定位到调用行

一、抛坑提问:校验失败在工具函数里 error,日志却指向工具函数那一行,排查总要翻两层。error 第二参 level 能…

2026-09-26 05:50 996 技术组
高级技巧996引擎

【高级技巧】Lua局部量200上限:裁决之杖仓库函数的寄存器分配

一、一行代码拆解:local a1, a2, a3 …… —— 单个函数最多 200 个活跃局部量,这是编译期硬限制;局部量…

2026-09-26 05:50 996 技术组