Cocos2d-x Lua 分帧处理大量数据｜默然的博客

热更新校验近 4 万条资源时，一次性遍历会长时间占用主线程。把任务拆成小批次，每帧处理一部分，可以让界面继续刷新并显示进度。

问题描述

对比本地与远程资源列表时，旧实现会在一帧内完成所有计算：

for k, v in pairs(remoteData.assets) do
    -- 计算逻辑
end

数据量较大时，低性能设备会出现界面假死。这里采用分帧处理：每帧校验固定数量的数据，完成后再停止调度器。

这不是并行计算，所有逻辑仍在主线程执行；它只是把一次长任务拆开，降低单帧阻塞时间。

分帧处理实现

function calcLogic()
    local key_table = {}
    for k, _ in pairs(remoteData.assets) do
        table.insert(key_table, k)
    end
    local index = 1                 -- 当前索引
    local total = #key_table        -- 总数量
    local batchSize = 1000          -- 每帧处理数量，可按设备性能调整

    -- 检验结束回调
    local function checkFinished()
        self._processFunc(100, "检查更新...(100%)")
    end

    -- 检测一条
    local function checkOne(index)
        -- 计算逻辑；正式环境避免逐条打印日志
    end

    -- update
    local function updateHandler()
        for i = 1, batchSize do
            if index <= total then
                checkOne(index)
                index = index + 1
            else
                -- 循环终止
                if self._checkTimer then
                    cc.Director:getInstance():getScheduler():unscheduleScriptEntry(self._checkTimer)
                end
                self._checkTimer = nil
                checkFinished()
                return
            end
        end
        -- 刷新进度条
        local finished = math.min(index - 1, total)
        local num = total > 0 and math.floor(finished * 100 / total) or 100
        self._processFunc(num, "资源重新校验中...(" .. num .. "%)")
    end

    -- 分帧检验开启
    if self._checkTimer == nil then
        self._checkTimer = cc.Director:getInstance():getScheduler():scheduleScriptFunc(updateHandler, 0, false)
    end
end

边界与性能建议

• 固定每帧 1000 条不等于固定耗时。若每条计算复杂度不同，建议按单帧时间预算停止本批处理，而不是只按数量切分。
• 页面退出、热更新取消或重新开始校验时，应主动 unscheduleScriptEntry，并清空 _checkTimer，避免旧任务继续操作已销毁对象。
• pairs 的遍历顺序不稳定。如果校验顺序影响结果，应先排序 key_table。
• 分帧只能避免单次长阻塞，不能减少总计算量。仍需避免循环内创建大量临时对象、逐条打印日志或重复读取磁盘。
• 需要共享进度时，完成回调和取消回调都应只触发一次。

相关阅读

• Cocos2d-x 定时器
• Cocos2d-x TTF Label 动态合批的实现与踩坑记录