【入门夯实】脚本的执行次序：顶层语句从上到下运行

学员常见误区

脚本从第一行到末行按顺序执行一次——函数定义本身也是语句，定义之前调用它就是调 nil。学员把主逻辑写在文件开头、函数定义堆在末尾，一加载就报 attempt to call a nil value，还以为是引擎没加载脚本。错误场景：

welcome()          -- 此刻 welcome 还是 nil
function welcome()
    print("欢迎来到玛法")
end

顶层调用发生在定义之前——attempt to call a nil value，报错行指向第一行。

正确姿势

顶层语句按书写顺序执行：先定义、后调用；主入口放文件末尾。规范写法。示例代码如下：

local function welcome()
    print("欢迎来到玛法")
end

welcome()   -- 定义之后的任何位置都可以调用

先定义后调用——文件末尾的主逻辑可以放心使用文件里定义的全部函数。

引擎验证

三步验证：把调用写在定义前复现 nil 报错；调整顺序后正常输出；在文件末尾加 print("脚本加载完成")，观察加载脚本时顶层的 print 会立即执行——顶层级代码是加载期就跑的。

举一反三

前向调用有标准解法：先把函数名声明为局部变量再赋值。示例代码如下：

local later   -- 先声明名字
later = function()
    print("后定义的函数也能被前面的代码引用")
end
later()

声明在前、赋值在后——闭包捕获的是变量本身，赋值完成后调用即有效。