入口函数写在文件开头、它调用的工具函数写在后面——其他语言（如 C 类的先声明后实现）都这么写，Lua 里却会炸：local function 定义的函数是局部变量，定义之前的代码里它不存在，调用拿到的是全局 nil。报错 attempt to call a nil value，报错行指向调用行，但根因是“被调函数在文件更下方才定义”。错误写法：
local function entry(actor)
prepare(actor)
end
local function prepare(actor)
sendmsg(actor, 1, "准备完成。")
end
entry(actor)
prepare 在 entry 之后才成为局部变量，entry 内看到的 prepare 是全局 nil。
被调函数先定义、入口函数收尾定义：定义顺序与调用顺序一致，局部引用链才完整。示例代码如下：
local function prepare(actor)
actor = getplayerbyname(actor)
sendmsg(actor, 1, "祖玛远征准备完成。")
end
local function entry(actor)
actor = getplayerbyname(actor)
prepare(actor)
sendmsg(actor, 1, "集结完毕，出发！")
end
本篇的新技术点是“入口收尾模式”：文件的主入口函数固定放末尾，所有工具函数在它之前定义——读代码从上往下就是执行顺序，无需跳转。
三步验证：误序版装载后调用 entry，报 attempt to call a nil value 且行号指向调用 prepare 那一行；调整顺序后重载，流程走通；用搜索确认 prepare 的 local 定义行在 entry 定义行之前。
确实需要“入口在前”的写法时，用前向声明：先 local entry 声明名字，再赋值函数体，两个函数互相调用也不会拿 nil。示例代码如下：
local entryA, entryB
entryA = function(actor)
actor = getplayerbyname(actor)
sendmsg(actor, 1, "A 调 B")
entryB(actor)
end
entryB = function(actor)
actor = getplayerbyname(actor)
sendmsg(actor, 1, "B 处理完毕")
end
全站技术干货持续更新：996 引擎 / Lua 实战帖，语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
设计初衷 活动币（节日代币、赛季积分）的灵魂问题是“过期怎么办”：永久保留则库存越滚越大、商店压力与经济失衡逐年加剧；一刀清…
设计初衷 打宝地图（高产出高风险的专属地图）是服务器产出的调节阀：普通图产出保底，打宝图产出上浮但设门槛。准入凭证的设计目标…
底层原理 把表转成可读字符串（调试输出、存档导出）时，循环引用是最大障碍：A 引用 B、B 引用 A，朴素递归无限展开直到栈…
底层原理 外部依赖抖动时，每次调用都傻等超时（2 秒），高峰期的失败请求排队堆积把脚本线程拖垮。熔断器的状态机：连续失败达到…
设计初衷 行会日常缺少“全 会一起嗨”的集体时刻：活动是少数人打的，福利是各自领的。行会祝福由会长或官员主动触发，全行会成员…
业务场景 新人入会是行会活跃的风向标：一条及时的欢迎语让新人三分钟内融入。自动欢迎的痛点是刷屏与模板疲劳：欢迎语千篇一律、连…