代码覆盖率

这是一个重要的可量化指标，如果代码覆盖率很高，你就可以放心的修改代码，在发版本的时候也能睡个安稳觉。否则就是拆东墙补西墙，陷入无尽的 bug 诅咒中。

那么在 OpenResty 里面如何看到代码覆盖率呢？其实很简单，使用 LuaCov 可以很方便的实现。

我们先了解下 LuaCov，这是一个针对 Lua 脚本的代码覆盖率工具，通过 luarocks 来安装：

  1. # luarocks install luacov

如果你的项目比较大，建议安装

  1. # luarocks install cluacov

后者通过 C 代码加速了 luacov 的耗时操作。亲测能够快近一倍呢。

安装了 LuaCov 之后，还需要先配置一下。

在 OpenResty 里面使用 LuaCov，只需要在 nginx.conf 中增加 init_by_lua_block（只能放在 http 上下文中）即可。

  1. init_by_lua_block {
  2.     require("luacov.tick")
  3.     jit.off()
  4. }

这个 *_bolck 语法在较新的 OpenResty 版本中新引入，如果提示指令不存在，请使用最新的版本来测试。 抑或在 LuaCov 配置文件 .luacov 中加入 tick = true 这一行。效果是一样的。

另外，由于 LuaCov 的分析文件默认按照 100 条一批来写入的，如果你的代码量不大，可能就会不准确。 这时候可以设置 savestepsize = 2 来提高写入频率。

更多可用配置请访问 LuaCov 的配置文档： http://keplerproject.github.io/luacov/doc/modules/luacov.defaults.html

重新启动 OpenResty 后，LuaCov 就已经生效了。你可以跑下单元测试，或者访问下 API 接口，在当前工作目录下，就会生成 luacov.stats.out 这个统计文件。然后 cd 到这个目录下，运行：

  1. # luacov

就会生成 luacov.report.out 这个可读性比较好的覆盖率报告。需要注意的是，luacov 这个命令后面不用加任何的参数，这个在官方文档里面有说明，只是比较隐晦。

我们看下 luacov.report.out 里面的一个片段：

  1. 1    function get_config(mid, args)
  2. 13      local configs = {}
  3. 13      local res, err = red:hmget("client_".. mid, "tpl_id", "gid")
  4. 13      if err then
  5. ****0      return nil, err
  6.         end
  7.      end

代码前面的数字，代表的是运行的次数。而 ****0 很明确的指出这行代码没有被测试案例覆盖到。

在 luacov.report.out 的最后会有一个汇总的覆盖率报告：

覆盖率报告

可以看到，在我的这个单元测试里面，一共涉及到近 20 个代码文件。其中倒数第三个是我测试的 API 接口，覆盖到的代码有 19 行，没有覆盖的有 3 行，所以代码覆盖率是 86.36%（19.0 / (19 + 3)）。

最后有一个总的代码覆盖率是 28.3%，这个值在跑完所有单元测试后是有意义的，单跑一个是没有参考价值的，因为很多基础函数可能并没有运行到。