【进阶必看】闭包与 upvalue：从捕获原理到热更新应用

完整课程入口：996 全套课程体系 ｜ Lua 学习路径 ｜ 幂尔框架 mirs.cn

闭包到底是什么

在 Lua 里，函数是"第一类值"——可以存进 table、当参数传递、也能被别的函数返回。当一个内部函数引用了外部函数的局部变量时，这对"函数 + 被捕获的变量"就叫闭包，那些被捕获的变量称为 upvalue。

理解 upvalue 的关键在于：它不是值的拷贝，而是变量本身的共享。两个闭包如果捕获了同一个外部局部变量，它们看到的是同一个存储槽，一个改、另一个立刻能读到：

local function makeCounter()
    local n = 0
    return {
        inc = function() n = n + 1; return n end,
        get = function() return n end,
    }
end
local c = makeCounter()
c.inc(); c.inc()
release_print(c.get())   -- 输出 2，两个闭包共享同一个 n

这个特性让闭包天然适合做"带私有状态的模块"：n 被闭包捕获后外部无法直接访问，只能通过返回的接口读写，等于免费的私有成员。

在游戏脚本里的三种典型用法

第一，回调携带上下文。 给按钮注册点击事件时，把界面元素、玩家数据直接捕获进闭包，回调触发时无需再查一遍：

GUI:addOnClickEvent(btn, function()
    SL:PlayAudio(71100)
    release_print("来自面板", panelId)
end)

第二，工厂函数批量生成逻辑。 每个怪物需要一份"受击后延时回血"逻辑，用工厂函数为每只怪生成独立闭包，各自持有自己的血量上限，互不干扰。

第三，装饰器与权限包裹。 写一个 wrap(old, check)，返回一个先做 GM 权限校验、再调用原函数的新闭包，可以无侵入地给一批管理函数统一加锁。

热更新里的关键角色

热更新的本质是"替换函数"，而函数替换能不能保住旧状态，全看 upvalue。直接用 load 编译出一份新函数覆盖全局接口时，新函数的 upvalue 是全新的，旧逻辑里积累的状态会丢。稳妥做法是替换后立刻把关键的旧 upvalue 逐个迁移过来，或者把状态统一寄存在 table 里、函数只作为无状态的纯逻辑被替换——这也是商业热更方案普遍要求"状态与逻辑分离"的原因。

最后一个坑：闭包会延长变量的生命周期。捕获了大对象（整张玩家数据表）的回调如果被注册进全局事件总线又从不反注册，这个大对象就永远不会被回收。凡是用闭包注册的监听，务必在界面销毁时成对移除。

延时回调

delaygoto(actor, time, func, del)

延时跳转，闭包最常见的载体就是延时回调，注意它不支持删除

delaygoto(actor,1000,"test_jump,ceshi,44",0)

grobaldelaygoto(time, funcName)

添加系统延时回调，需要可管理生命周期的回调走这条

cleardelaygoto(actor, func)

删除延迟，回调删除后闭包捕获的变量才可能被回收

定时回调

setontimerex(id, tick)

添加全局定时器，定时器回调同样会持有闭包，漏摘就是泄漏

setofftimerex(id)

移除全局定时器，成对使用

ontimerexX(empty)

全局定时器触发(X=触发器ID)，回调里访问 upvalue 的时机要确认清楚

调试

release_print(msg)

打印消息到控制台，看 upvalue 是否还在被引用，靠打印最直接