【高级技巧】惰性单例：首次访问才初始化的模块

底层原理

全服共享的模块（行会配置中心、禁言名单）只需要一份实例，但初始化成本高（读库、建索引）。 eager 单例在脚本装载时立即构建——哪怕这次运行根本没人用它。惰性单例把初始化推迟到首次访问：入口函数检查“实例是否存在”，不存在才构建。单线程引擎里这个检查天然安全，不存在并发竞态；构建完成后的所有访问都走同一份实例，全局唯一性由“实例存进局部上值”保证。

高级封装

惰性单例工厂：实例藏在闭包里，首次调用构建，之后直接复用。示例代码如下：

local function lazySingleton(builder)
    local instance = nil
    return function()
        if instance == nil then
            instance = builder()
            sendmsg(nil, 1, "实例首次构建完成。")
        end
        return instance
    end
end
local function buildGuildConfig()
    local cfg = { maxMember = 100, dailyReset = 1 }
    return cfg
end
local getGuildConfig = lazySingleton(buildGuildConfig)

业务接入：每次调用入口函数，首访构建、后续直取。示例代码如下：

local function checkGuildLevel(actor)
    actor = getplayerbyname(actor)
    local cfg = getGuildConfig()
    if cfg == nil then
        sendmsg(actor, 1, "配置加载失败。")
        return
    end
    sendmsg(actor, 1, "行会上限 " .. cfg.maxMember .. " 人。")
end

本篇的新技术点是“实例存上值”：instance 是闭包的上值，首次构建后一直存活——单例的“全局唯一”不靠全局变量，靠上值的生命周期。

性能对比

eager 与 lazy 对比（配置构建 8ms、日均实际使用 3 次）：eager 每次脚本装载都花 8ms，一天装载 40 次合计 320ms 全是白算；lazy 首次访问才付 8ms，之后 0.0002ms 直取。内存两者相当（同一份实例）。惰性的额外收益：构建失败（数据库抖动）只影响当次调用，下次访问自动重试构建——eager 版装载失败整个脚本报废。

适用边界

构建成本高且使用频率低的模块是惰性单例的主场；装载即必须可用的核心模块（错一天都不行）用 eager 并在装载期暴露问题。惰性单例的构建函数要幂等——重试构建时第一次的残留不能污染第二次结果。另外，instance == nil 的判定要求构建函数绝不返回 nil，构建失败请抛错而不是返回 nil，否则每次访问都重试构建。