三年迭代的脚本库里躺着大量死函数:下线功能没删干净、复制粘贴的变体无人调用、迭代残留的旧版本。每个函数在 Lua 里都是独立的函数原型对象(F:\底层文件 的 Proto 结构:指令数组加常量表独立分配),死函数占内存、拖慢加载,更大的危害是干扰维护——热更改了一个从未被调用的函数,改完"验证生效"其实线上跑的根本不是它。发现死函数的可行手段是引用扫描:从全局表与已知注册表出发,统计每个函数被引用的路径数,零引用者进入下线候选。
引用扫描器与清理流程:遍历全局表标记函数引用路径。示例代码如下:
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
清理执行对照示例代码如下:
reportDead({ "oldFireCalc", "legacyEscort", "testTmp" })
报告列出三个候选,人工确认后从源码删除并走正常热更。
一次全库扫描(约 900 个全局符号、4200 张表)耗时约 600 毫秒,只能在诊断机或维护窗口跑。清理收益:删掉 180 个死函数后,脚本库内存下降约 1.2MB,启动加载时间从 850 毫秒降到 790 毫秒;更实际的是热更排错效率——改动目标里"幽灵函数"(改了不生效的)占比从三成降到零,平均排错时间缩短近一半。扫描报告本身只读不改,删除动作始终走人工确认加正常发布流程。
三个不适用场景:一是引擎按约定反射调用的触发入口(ontimer12 这类命名函数)不经过全局引用扫描能覆盖的路径,零引用报告会误杀它们,触发入口名单要人工排除;二是灰度下线的功能(还可能回滚开启)不删只标记,保留一个版本观察期再进清理名单;三是扫描层数超过 5 层的深层表里的引用会漏报,深层挂载的函数要先人工梳理挂载点再跑扫描。
全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
一、一行代码拆解:local function roll() 里写 local cfg = {500, 200, 50} —…
一、隐蔽陷阱:国库金币累加到 2^53(约 9007199254740992)之后再加 1,数值纹丝不动——双精度浮点在该区…
一、线上事故:仓库存取逻辑散在 6 个脚本,各自写各自的 getsysvar 键名,某次改名漏改 2 处,300 件裁决之杖…
一、抛坑提问:500 件战备装备一次下发必卡,按每页 20 件切片,边界怎么算才不出空页和重页?起点 (page-1) 20…
一、抛坑提问:校验失败在工具函数里 error,日志却指向工具函数那一行,排查总要翻两层。error 第二参 level 能…
一、一行代码拆解:local a1, a2, a3 …… —— 单个函数最多 200 个活跃局部量,这是编译期硬限制;局部量…