【Lua实战】前向声明：模块内函数相互调用的正确姿势

实战应用：用在哪里

模块里的两个函数互相调用：A 调 B、B 又调 A——local function 的声明顺序让后声明的函数在前者眼里是 nil。前向声明是 Lua 模块内相互调用的标准解法，声明与赋值的分离让调用顺序不再是雷区。

问题的现场

---错误现场：local 的顺序依赖
local function isBoss(name)
    return name == '祖玛教主' or isElite(name)
end

local function isElite(name)          -- 此时 isElite 还是 nil
    return name == '沃玛卫士'
end

print(isBoss('沃玛卫士'))              -- 报错：尝试调用 nil

local function 的本质是「声明局部变量再赋值」：isBoss 定义时引用的 isElite 还未声明，闭包捕获到的是当时的 nil——调用的瞬间报 attempt to call a nil value。错误在定义时不报、在调用时才爆，这种延迟的雷在模块变大后排查极痛。

前向声明的解法

---前向声明：先声明名字，再赋值实现
local isElite                        -- 前向声明

local function isBoss(name)
    return name == '祖玛教主' or isElite(name)
end

function isElite(name)               -- 为前向声明的局部变量赋值
    return name == '沃玛卫士'
end

print(isBoss('沃玛卫士'))             -- true，调用链完整

前向声明的写法两步：模块顶部先 local isElite 声明名字，实现在下方用 function isElite(...) 赋值——赋值时省略 local（否则又是一个新的局部变量），闭包捕获的引用在前向声明处已存在。模块间的相互调用同理：两个模块互相引用时，把共享的接口先声明或改走事件总线。前向声明的位置纪律：声明集中在模块的头部区域，散落的声明让依赖关系变得不可读。

验证与监控

模块加载的自检：加载完成后立即调用模块的每个导出函数做 smoke 断言，nil 的引用在启动期暴露；静态检查扫描「引用了后方 local 函数」的模式，前向声明的遗漏在提交期拦截。

踩坑记录

前向声明曾经省略 local 直接写全局，函数泄漏进全局表造成跨模块的覆盖事故，声明与赋值的成对纪律进评审。循环调用的两个函数曾经都在闭包里捕获对方的旧值，热更新后一边新一边旧，模块级的重载整体刷新。声明的位置曾经放在使用之后很远，维护者误删声明导致全线报错，头部的集中声明区让依赖可见。

上线要点

模块内相互调用的规范：前向声明置顶、实现置后、调用置中，结构一目了然。加载期的 smoke 断言覆盖模块的每个导出，nil 引用在起服时暴露。代码评审对 local 的顺序敏感，重构的移动带着声明一起走。