CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
入门夯实996引擎函数定义执行顺序

【入门夯实】循环内先定义:函数调用的顺序红线

2026-09-24 21:49 作者:996 技术组 996引擎Lua教程传奇脚本入门夯实996引擎Lua函数定义执行顺序

学员常见误区

Lua 脚本自上而下顺序执行,学员把函数定义写在调用之后:循环体第一轮调用时,局部函数还是 nil,报 attempt to call a nil value——报错行指向调用处,根因却在几行之后的定义。另一类浪费是把函数定义写进循环体:每轮创建一个新闭包,1000 轮循环产生 1000 个函数对象,GC 压力无谓翻倍。错误场景:

lua
for i = 1, 100 do
    local function give(i)
        sendmsg(nil, 1, "发放第 " .. i .. " 份奖励")
    end
    give(i)
end

这里定义紧跟调用能跑,但闭包创建了 100 次;若把调用挪到定义之前一行,直接报 nil 调用错误。

正确姿势

函数定义提到循环外,循环内只调用;文件内遵循"先定义后调用"的书写顺序。行会战 100 名参战者发放奖励的正确结构。示例代码如下:

lua
local function giveReward(name, i)
    local actor = getplayerbyname(name)
    if actor then
        giveitem(actor, "金币", i * 1000, 0, "行会战奖励")
        sendmsg(actor, 1, "获得第 " .. i .. " 档奖励 " .. i * 1000 .. " 金币")
    end
end
for i, name in ipairs(warMembers) do
    giveReward(name, i)
end

定义一次、调用 100 次,闭包只有 1 个;函数体内的局部变量每轮照常独立。示例代码如下:

lua
local function buildLine(members)
    local parts = {}
    for i, m in ipairs(members) do
        parts[i] = i .. "." .. m
    end
    return table.concat(parts, "、")
end

引擎验证

三步验证:把 giveReward 的调用提到定义之前复现 nil 调用报错;在定义行加计数器,循环 100 次后计数应为 1(定义只执行一次);循环外定义与循环内定义各跑 10 万次循环,对比 GC 周期次数。

举一反三

必须"先用后定义"的场景(互相递归调用)用前向声明:先 local 声明名字,再赋函数体,两个函数都能看到对方。示例代码如下:

lua
local isEven, isOdd
function isEven(n)
    if n == 0 then
        return true
    end
    return isOdd(n - 1)
end
isOdd = function(n)
    if n == 0 then
        return false
    end
    return isEven(n - 1)
end
作者履历与出处

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。

← 返回文章地图返回研学路径

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

策划架构996引擎

【策划架构】帮会试炼场:限时挑战的门票与积分设计

设计初衷 帮会活动只有攻城与聚餐两板斧:非攻城日帮会频道冷清,成员缺乏共同目标。帮会试炼场设计:帮会自有试炼场(限时挑战波次…

2026-09-26 03:53 996 技术组
策划架构996引擎

【策划架构】帮会会费:成员会费的收缴与公示设计

设计初衷 帮会资金靠少数大佬捐献:金主一走帮会资金断崖,普通成员没有参与感也不会珍惜帮会资源。帮会会费设计:成员按职位每周缴…

2026-09-26 03:53 996 技术组
策划架构996引擎

【策划架构】募兵编制:帮会扩军的募兵与编制作业设计

设计初衷 帮会扩张靠熟人拉人:增长有天花板、新人质量参差、老人不愿带新。募兵编制设计:帮会发布募兵任务包(新人完成入帮任务即…

2026-09-26 03:53 996 技术组
高级技巧996引擎

【高级技巧】协程超时兜底:resume与pcall的组合封装

底层原理 协程体内出错时 resume 返回 ok=false 与错误对象,但协程体若死循环则 resume 永久挂起——错…

2026-09-26 03:53 996 技术组
高级技巧996引擎

【高级技巧】协程双向通信:resume传参与yield回传封装

底层原理 coroutine.resume 的实参会在协程内成为首个 yield 的返回值;coroutine.yield …

2026-09-26 03:53 996 技术组
进阶实战996引擎

【进阶实战】摆摊自动补货:摊位库存的定时补齐封装

业务场景 挂摊卖药每小时断货:玩家下线前上满货,两小时后摊位空转。摊位自动补货封装:上摊时设定补货仓库(背包或帮会仓),定时…

2026-09-26 03:53 996 技术组