【高级技巧】Lua三色标记：裁决之杖上架时的GC卡顿

一、隐蔽陷阱：商店批量上架 500 件裁决之杖的瞬间全服卡顿 200 毫秒——时间点掐得很准，恰逢垃圾回收进入标记阶段。
二、底层原理：Lua 的 GC 采用三色标记：白色待回收、灰色待扫描、黑色已确认存活；一次性新建大量表会让灰色队列暴涨，标记阶段被拉长，卡顿就发生在这段集中的扫描里。
三、正确代码：
错误写法：

lua

for i = 1, 500 do
    shelf[i] = { name = "裁决之杖",
        price = 5000 + i, owner = actor }
end       -- 集中创建触发长标记

正确写法：

lua

collectgarbage("collect")      -- 上架前主动清一次
for i = 1, 500 do
    shelf[i] = { name = "裁决之杖",
        price = 5000 + i, owner = actor }
end
collectgarbage("step")         -- 余量分步回收

四、引擎验证：M2 曲线对比批量上架前后的 GC 停顿，主动收集后峰值从 200 毫秒降至 8 毫秒。
五、FAQ：问：白色对象一定会被回收吗？答：不可达的白色对象才会，标记期间被重新引用的会转灰。

作者履历与出处

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

📖 接口说明API × 3

collectgarbage

collectgarbage("count", 标准库, 统计或触发 Lua GC，内存排查的测量起点。, count 模式返回当前 Lua 内存（KB）)

"count"

标准库

统计或触发 Lua GC，内存排查的测量起点。

count 模式返回当前 Lua 内存（KB）

返回：见说明

string.unpack

string.unpack(fmt, s [, init], 标准库, 按格式解二进制串，长度前缀协议拆包的核心函数（Lua 5.3+）。, 值, 下一个位置)

fmt

s [

init]

标准库

按格式解二进制串，长度前缀协议拆包的核心函数（Lua 5.3+）。

值

下一个位置

返回：见说明

setmetatable setmetatable(t, mt, 标准库, 设置元表，Lua 面向对象类系统的基石。, t 本身)

标准库

设置元表，Lua 面向对象类系统的基石。

t 本身

返回：见说明

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

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

帮会BOSS讨伐：每日召唤与伤害排名奖励

帮会团本：全团共享血量的阶段挑战

Lua树状数组：单点更新与区间求和

登录累计奖励：连登天数的阶梯礼包

Lua大数乘法：竖式逐位乘的错位累加

Lua最小公倍数：辗转相除派生的倍数求解