CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
进阶实战游戏功能996引擎

Lua+闭包计数:upvalue的共享本质

2026-09-29 12:45 作者:996 技术组 996引擎Lua教程传奇脚本进阶实战游戏功能996引擎

【语法算法】

闭包计数的共享本质就这一行:

lua
local count = 0
return function() count = count + 1 end

count 不是全局变量也不是局部变量——它是 upvalue,被闭包捕获后的外部局部变量。三个闭包捕获同一个 count,改的是同一份值。今天拆开。

一、捕获、共享、独立三段

闭包计数的三段。捕获:内层函数引用外层函数的局部变量——被引用的那个变量就变成了 upvalue,从栈上搬到了堆上。共享:两个闭包如果捕获的是同一个外层变量的同一个实例,它们共享同一份值——改了一个另一个也变。独立:如果外层函数被调用两次,每次调用都创建新的局部变量实例——两次调用的闭包各自独立,互不干扰。三段连起来:闭包计数的本质是"谁捕获了同一个变量实例,谁就共享它"。

mermaid
graph TD
    A[外层函数 counter] --> B[局部变量 count = 0]
    A --> C[内层函数 add]
    A --> D[内层函数 get]
    C -->|捕获| B
    D -->|捕获| B
    B --> E[堆上的 upvalue]
    C --> F[闭包1]
    D --> G[闭包2]
    F -->|共享| E
    G -->|共享| E

二、计数器的正确写法

lua
local function createCounter()
    local count = 0
    local function add(n)
        count = count + n
    end
    local function get()
        return count
    end
    local function reset()
        count = 0
    end
    return {
        add = add,
        get = get,
        reset = reset,
    }
end

local c1 = createCounter()
local c2 = createCounter()

c1.add(5)
c2.add(3)

print(c1.get())  -- 5
print(c2.get())  -- 3

c1 和 c2 调用了两次 createCounter()——每次调用都创建新的 count 局部变量——所以 c1 和 c2 的 count 各自独立。这就是"两次调用两个实例"的独立段。

三、共享与独立的分界线

共享和独立的分界线就一条:是否来自同一次外层函数调用。同一次调用创建的闭包共享同一份 upvalue——不同次调用的闭包各自独立。这条分界线在实际项目里的意义是:模块级单例的闭包永远只有一份(模块只被 require 一次),而对象方法的闭包每个实例各有一份(每个对象调用一次构造函数)。分清这两条线,闭包计数就不会出错。最后一条:count = count + 1 这行代码里 count 是 upvalue 而不是全局变量——Lua 的作用域规则是"先找局部,再找 upvalue,最后找全局"——内层函数写 count 的时候,Lua 自动找到了外层的局部变量并把它提升为 upvalue,这个过程完全是自动的,不需要任何关键字。

作者履历与出处

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

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

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

LATEST ARTICLES

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

进阶实战游戏功能

影锁:影锁绑你绑它,锁期拼刀

【游戏功能】 控制技能的镜像问题是:锁住了怪,自己是不是也闲着?影锁把这道两难摆上台面:影锁四秒,它动不了、你也动不了——它…

2026-10-01 10:00 996 技术组
进阶实战游戏功能

震魂:震魂入体叠加出招自损

【游戏功能】 打断为什么只有"清读条"一种?震魂偏要反过来——不清招、不断势,打在它读条半途的那一劲顺着招震进腑——中劲十秒…

2026-10-01 10:00 996 技术组
进阶实战游戏功能

蜂王:喂小怪蜂王进化,三阶蜂王蜇翻全场

【游戏功能】 蜂群为什么总是一只一只出?蜂王偏要让它们进化:放一只蜂王出来,杀掉小怪喂它——喂三只升一阶,三阶蜂王的毒刺一秒…

2026-10-01 10:00 996 技术组
进阶实战游戏功能

血刃:每刀扣血换吸血,血刀双刃

【游戏功能】 技能为什么总是不扣自己的血?血刃偏要反着来:开着血刃的每一刀先扣自己二血、命中回三血——净赚一但要打得中,空刀…

2026-10-01 10:00 996 技术组
进阶实战游戏功能

破军旗:旗立三秒圈内加攻,旗倒攻散

【游戏功能】 bn.t = bn.t - dt ——一行旗面倒计时的代码,撑起了破军旗全部的紧迫感:旗立三秒、圈内加攻三成,…

2026-10-01 10:00 996 技术组
进阶实战游戏功能

淬毒刃:淬毒三刀叠一层,一层毒过一秒六

【游戏功能】 淬毒为什么要一毒到底?淬毒刃偏要一层一层叠:一刀淬一层毒、毒层一秒六地烂,六层封顶之后一刀下去毒伤三十六——叠…

2026-10-01 10:00 996 技术组