【Lua进阶】await 风格协程：把回调串成顺序逻辑的封装

实战应用：用在哪里

技能前摇 0.5 秒后结算、播放动画完成后开宝箱、等待服务器响应后刷新界面——这类"等待某事件后继续"的逻辑，回调写法层层嵌套。用协程把异步流程写成顺序代码，是 Lua 里最接近 async/await 的方案。适用于：技能流程、引导步骤、副本阶段控制。

await 封装：协程 + 完成回调对接

local function await(asyncFn)
    local co = coroutine.running()
    asyncFn(function(result)
        coroutine.resume(co, result)
    end)
    return coroutine.yield()
end

-- 业务代码变成顺序形态
local function openChestFlow()
    local anim = await(playAnim("open", 0.5))
    local reward = await(requestServer("chest_open"))
    showReward(reward)
end

await 内部：当前协程 yield 挂起，等异步完成时 resume 并带回结果。调用方读起来就是三行顺序逻辑，错误处理可以再包一层 pcall 版 await。

驱动方式两种

入口协程驱动：业务入口用 coroutine.wrap(openChestFlow)() 启动，后续 resume 由各异步完成回调触发。调度器驱动：协程 yield 时返回"等待条件"，统一调度器轮询条件满足后 resume——配合定时器系统能实现"等 3 秒""等下一帧""等服务器返回"三类等待的统一写法。

三个必守规则

协程不能跨场景存活。 界面销毁后，挂起的协程恢复时会操作失效节点——协程绑定到界面的生命周期，销毁时标记协程作废（resume 前检查）。await 不能在主逻辑线程外调用（非协程环境直接 yield 会报错），封装层对 coroutine.isyieldable() 做断言。超时保护必备。 等待的服务器响应可能永远不来，await 包装器加超时参数（如 5 秒未恢复则 error），防止流程永久挂起。

实测收益

某开箱流程从 4 层回调嵌套重构为 6 行顺序代码，同类的引导流程、Boss 掉落流程随后全部迁移。新功能开发时先用 await 写出"理想顺序"，再把每一步替换成具体的异步实现——协程把异步代码的编写方式拉回了同步时代的心智模型。

与引擎触发的衔接示例：技能触发的 QF 回调里启动协程，协程内部再 await 各步骤。入口模板固定为一段 6 行代码，新流程复制模板改步骤即可。协程数量按流程计，一场战斗几十个协程的调度开销低于 0.1ms，量级安全。

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