Defold 内存管理与对象池实战

It may seem like a good idea to save spawned game objects in a pool
and reuse them. However, the engine is already doing object pooling
under the hood so additional overhead will only slow things down.
It is both faster and cleaner to delete game objects and spawn new ones.

1. Lua 表与字符串的频繁创建 —— 触发 GC 抖动
2. 资源首次加载 —— 造成掉帧卡顿
3. 组件计数配置过大 —— 常驻内存浪费

引擎与资源   引擎代码、纹理、声音、字体等，由资源树决定
对象与组件   集合创建时按组件计数一次性预分配
Lua 堆       脚本里的表、字符串、闭包，由 Lua GC 管理
图形缓冲     顶点、索引、后备缓冲，受分辨率与 high_dpi 影响

-- Lua 堆用量，单位 KB
local kb = collectgarbage("count")
print(string.format("lua heap: %.1f KB", kb))

-- 主动触发一次 GC（谨慎使用，会卡顿）
collectgarbage("collect")

-- HTML5 平台看 wasm 堆
if html5 then
    print(html5.run("HEAP8.length") / 1024 / 1024)
end

-- 普通工厂
local id = factory.create("#bullet_factory", pos, nil, { damage = 10 }, 1.5)

-- 批量创建后统一删除
local ids = {}
for i = 1, 20 do table.insert(ids, factory.create("#enemy_factory")) end
go.delete(ids)   -- 也接受表，一次性删掉

-- 同步：第一次 create 时才加载，会造成一次卡顿
function init(self)
    self.go_id = factory.create("#bullet_factory")
end

-- 异步：显式 load，加载完回调里再生成，不卡帧
local function load_complete(self, url, result)
    self.go_id = factory.create(url)
end

function init(self)
    factory.load("#bullet_factory", load_complete)
end

function final(self)
    go.delete(self.go_id)
    factory.unload("#bullet_factory")   -- 减引用，无人引用时真正卸载
end

factory.unload("#factory")
factory.set_prototype("#factory", "/main/levels/enemy_b.goc")
local enemy_id = factory.create("#factory")

-- bullet_pool.lua
local M = {}

local pool = {}

function M.get()
    local b = table.remove(pool)
    if not b then
        b = { x = 0, y = 0, vx = 0, vy = 0, active = false }
    end
    return b
end

function M.release(b)
    b.active = false
    pool[#pool + 1] = b
end

return M

local bullet_pool = require("bullet_pool")

function update(self, dt)
    for i = #self.bullets, 1, -1 do
        local b = self.bullets[i]
        b.x = b.x + b.vx * dt
        if b.x > 2000 then
            bullet_pool.release(b)
            table.remove(self.bullets, i)   -- 关键：从活跃列表移除
        end
    end
end

-- 不好：每帧新建字符串
local key = "hp_" .. self.id
self[key] = self.hp

-- 好：预计算 hash，或直接用数值索引
local KEY_HP = hash("hp")
self[KEY_HP] = self.hp

- 集合加载时，集合内直接引用的资源计数 +1
- 工厂 / 集合工厂持有的原型资源计数 +1
- 动态加载的资源在 load 后计数 +1
- go.delete 掉实例会减少对应计数
- factory.unload 减少工厂持有的那份引用

local path = "/assets/level1.atlas"
resource.load(path, { type = resource.ATLAS }, function(self, path, result)
    if result then
        self.atlas = resource.get(path, "atlas")
    end
end)

-- 不再需要时释放引用
resource.release("/assets/level1.atlas")

msg.post("#level_proxy", "load")     -- 异步加载
msg.post("#level_proxy", "unload")   -- 卸载整个世界

sprite.max_count        每集合最大精灵数
gui.max_nodes           每集合最大 GUI 节点数
light.max_count         最大光源组件数，默认 64
collection.max_instances 每世界最大 game object 数

[html5]
heap_size = 64

-- 在游戏里监控
if html5 then
    print(html5.run("HEAP8.length") / 1024 / 1024)
end

现象：内存只涨不降
检查：
1. 是否有表一直往 self.xxx 里 insert 却从不 remove
2. 是否注册了 timer / listener / 订阅却忘了取消
3. 是否 go.delete 了对象但外部仍持有其 id 或数据引用
4. 是否 load 了资源却没有对应 release / unload
5. 集合代理是否 load 了新的却没 unload 旧的
6. 是否每帧都在新建闭包或字符串

-- 定时打印 Lua 堆，观察是否单调上升
timer.delay(5, true, function(self, handle, time_elapsed)
    print("lua kb:", collectgarbage("count"))
end)