【工程效率】luacheck + busted：Lua 代码规范与自动化测试

脚本多到必须上工具

项目过了几千个 Lua 文件，纯靠人眼 review 必然失控：未使用变量、全局污染、空函数、循环里悄悄改循环变量……这些低级但高发的问题，静态检查工具一次全扫出来。工具链的价值不在于"代码写得更漂亮"，而在于把review 精力留给真正的业务逻辑。

luacheck：把规范变成机器执行

luacheck 是 Lua 生态最常用的静态检查器，检查的是"结构性问题"而非功能：未定义全局（手滑没写 local 的第一现场）、未使用变量与参数、遮蔽上层变量、空代码块、行宽等。它有官方的告警编号体系，团队可以按需开关：

luacheck src/ --globals release_print SL lib996 --no-max-line-length
luacheck src/ --std luajit --codes

--globals 用于登记引擎注入的全局（SL、lib996 这类），否则满屏误报没人会坚持用。真正落地时配一个 .luacheckrc 配置文件进版本库，全员同一套标准；再接进构建流水线，检查不过就不出包——规范只有自动执行才叫规范，靠自觉的规范活不过三个月。

busted：给核心逻辑上保险

busted 是 Lua 的行为驱动测试框架，语法接近自然语言：

describe("爆率计算", function()
    it("千分比概率应落在 0-1000", function()
        local r = calcDropRate( { base = 500 } )
        assert.is_true(r >= 0 and r <= 1000)
    end)

    it("幸运值满值必出", function()
        assert.equals(1000, calcDropRate( { base = 500, lucky = 500 } ))
    end)
end)

不必追求全覆盖，只测"值得测的"：爆率与数值公式、存档合并、协议解析、热更状态迁移——这些出一次事故就很疼的纯逻辑函数，是单测性价比最高的地方。写测试还会倒逼函数设计变纯（输入决定输出、不偷偷改全局），而纯函数恰恰是最容易热更和测试的。

流水线串起来

最小可用流水线三步：提交前本地跑 luacheck；构建机自动跑 busted 全量用例；任一步失败即中止出包。有条件再加一步：用测试跑出来的覆盖率报告约束核心模块不低于目标行数。半天就能搭完，之后每次热更、每次改爆率，都有一层机器兜底——这比事后在群里问"谁动了这个文件"有效得多。