模块与封装：把 QF 拆成工具箱

模块就是工具箱。后端命令八百多个，记不住很正常——把自己常用的封装起来，按名字调用。

一、include 与 require

include("我的模块.lua")   -- 每次都加载
require("我的模块")       -- 只加载一次

线上频繁重载 QF、模块又多，优先 require，省内存、少重复。

二、最简模块

我的模块.lua

local P = print
P("我是我的模块")

QF 顶部

include("我的模块.lua")

注意加载顺序：Lua 从上往下读。调用写在定义前会报 尝试 call 空值。定义/加载放上面，调用放下面。

三、模块返回 table（推荐）

-- 封装.lua
local T = {}
function T.getName(actor)
    return GetBaseInfo(actor, 1)
end
function T.getLevel(actor)
    return GetBaseInfo(actor, 6)
end
return T

-- QF
local t = require("封装")   -- 或 include + 接收返回值
print(t.getName(actor))
print(t.getLevel(actor))

return T 把工具箱交出去；外面用局部变量接，避免全局被覆盖。

四、为什么要 return 而不是裸全局

若模块里写全局 T = {...}，别人也写个 T = 123，你的方法就没了。
局部 + return = 私有化，谁拿到返回值谁才能用。

五、表里可以放函数（匿名）

local T = {
    getName = function(actor) return GetBaseInfo(actor, 1) end,
    getLevel = function(actor) return GetBaseInfo(actor, 6) end,
}

getName = function(...) 是匿名函数赋值给主键，和 function T.getName() 本质一样。

六、触发里才有 actor

actor 是引擎回调参数。全局脚本顶层没有“是谁”，拿不到对象。练手可以先写在奔跑/聊天触发里。

今日练习：写 封装.lua 导出 getName / getLevel，在奔跑触发调用；再故意用同名全局覆盖，观察报错，改成 return 后修复。