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

完整课程入口：996 全套课程体系 ｜ Lua 学习路径 ｜ 幂尔框架 mirs.cn

脚本多到必须上工具

项目过了几千个 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 全量用例；任一步失败即中止出包。有条件再加一步：用测试跑出来的覆盖率报告约束核心模块不低于目标行数。半天就能搭完，之后每次热更、每次改爆率，都有一层机器兜底——这比事后在群里问"谁动了这个文件"有效得多。

测试输出

release_print(msg)

打印消息到控制台，断言失败与用例名输出到控制台，开发期足够用

logact(play, logAct, loginfo, nParam1, nParam2, nParam3, nParam4, nParam5)

自定义日志，把用例结果写入日志通道，便于与构建记录对应

耗时基线

printusetime(play, on, off)

打印脚本总耗时(微秒)，给关键用例加耗时基线，性能回退能被测试拦住

用例装载

require(path)

加载文件，测试用例与业务模块走同一套加载机制，避免环境差异

规范校核

checkcontainstextlist(path, str,model, result)

检查字符串是否在指定文件中，规范清单类校验可以直接读文件比对