【性能调优】热点函数内联：战斗结算的提速

实战应用：用在哪里

Lua 的函数调用开销在战斗结算的热路径上被放大：千人攻城的每一次伤害结算要调用数十个属性函数，调用栈的开销累积可观。热点函数的内联与查表化，是战斗系统提速的低成本手段。

热点的定位

---战斗结算的热点统计
function Profile.hot(fn, loops)
    local t0 = os.clock()
    for i = 1, loops do fn(i) end
    local cost = (os.clock() - t0) / loops * 1e6
    print(string.format("%.2f us/次", cost))
end
Profile.hot(function(i) Combat.calcDamage(attacker, defender, i) end, 10000)

微基准定位热点：单次耗时的微秒数直接可比。战斗结算的热点通常集中在三处：属性读取的链式调用、伤害公式的浮点运算、字符串拼接的日志。火焰图或简单计数器都能定位，关键是数据驱动而非直觉。

内联的改造

---改造前：链式函数调用
-- local atk = actor:GetAttack() + actor:GetBuffAtk() + actor:GetTitleAtk()

---改造后：合并为单次查表
local COMBAT_ATK = { [1] = 0 }
function Combat.inlineAtk(actor)
    return actor.baseAtk + actor.buffAtk + (actor.titleAtk or 0)
end

改造把三次方法调用合并为三次字段访问，字段访问在 Lua 里比方法调用快数倍。属性缓存策略：进战斗时快照属性，战斗中不重复计算基础值，BUFF 生效时增量更新快照。内联的边界要克制：只内联 top3 热点，全量内联让代码膨胀且难以维护。

验证与监控

改造前后的基准对比必须跑同一数据集，单次结算耗时下降 30% 以上才算有效。

踩坑记录

属性缓存曾经忘记在 BUFF 到期时失效，玩家看到面板数值与实际伤害不一致，缓存的失效钩子与 buff 到期事件绑定后修复。过度内联让伤害公式分散在五处，一处调整漏改三处，内联范围收敛到结算主循环后回归可控。

上线要点

热点统计常态化：每周跑一次基准，性能回归在数据上可见。内联的代码块加注释标记来源公式，可读性与性能的平衡靠注释维持。攻城战的服务器负载与结算耗时联动监控，千人同屏的结算耗时超过 50 毫秒即告警。

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