使用 Gcov 和 LCOV 度量 C/C++ 项目的代码覆盖率

# 这是我的测试环境上的 GCC 和 lcov 的版本 sh-4.2$ gcc --version gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-39) Copyright (C) 2015 Free Software Foundation, Inc. This is free software; see the source for copying conditions.  There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. sh-4.2$ lcov -v lcov: LCOV version 1.14 

make 

make 命令的输出

sh-4.2$ make gcc -fPIC -fprofile-arcs -ftest-coverage -c -Wall -Werror main.c gcc -fPIC -fprofile-arcs -ftest-coverage -c -Wall -Werror foo.c gcc -fPIC -fprofile-arcs -ftest-coverage -o main main.o foo.o 

通过输出可以看到，这个程序在编译的时候添加了两个编译选项 -fprofile-arcs and -ftest-coverage。在编译成功后，不仅生成了 main and .o 文件，同时还生成了两个 .gcno 文件.

.gcno 记录文件是在加入 GCC 编译选项 -ftest-coverage 后生成的，在编译过程中它包含用于重建基本块图和为块分配源行号的信息。

2. 运行可执行文件

在编译完成后，生成了 main 这个可执行文件，运行（测试）它：

./main 

运行 main 时输出

sh-4.2$ ./main Start calling foo() ... when num is equal to 1... when num is equal to 2... 

当运行 main 后，执行结果被记录在了 .gcda 这个数据文件里，查看当前目录下可以看到一共有生成了两个 .gcda 文件，每个源文件都对应一个  .gcda 文件。

$ ls foo.c  foo.gcda  foo.gcno  foo.h  foo.o  img  main  main.c  main.gcda  main.gcno  main.o  makefile  README.md 

.gcda 记录数据文件的生成是因为程序在编译的时候引入了 -fprofile-arcs 选项。它包含弧过渡计数、值分布计数和一些摘要信息。

3. 生成报告

make report 

生成报告的输出

sh-4.2$ make report gcov main.c foo.c File 'main.c' Lines executed:100.00% of 5 Creating 'main.c.gcov' File 'foo.c' Lines executed:85.71% of 7 Creating 'foo.c.gcov' Lines executed:91.67% of 12 lcov --capture --directory . --output-file coverage.info Capturing coverage data from . Found gcov version: 4.8.5 Scanning . for .gcda files ... Found 2 data files in . Processing foo.gcda geninfo: WARNING: cannot find an entry for main.c.gcov in .gcno file, skipping file! Processing main.gcda Finished .info-file creation genhtml coverage.info --output-directory out Reading data file coverage.info Found 2 entries. Found common filename prefix "/workspace/coco" Writing .css and .png files. Generating output. Processing file gcov-example/main.c Processing file gcov-example/foo.c Writing directory view page. Overall coverage rate:   lines......: 91.7% (11 of 12 lines)   functions..: 100.0% (2 of 2 functions) 

执行 make report 来生成 HTML 报告，这条命令的背后实际上主要执行了以下两个步骤：

1. 在有了编译和运行时候生成的 .gcno 和 .gcda 文件后，执行命令 gcov main.c foo.c 即可生成 .gcov 代码覆盖率文件。

2. 有了代码覆盖率 .gcov 文件，通过 LCOV[5] 生成可视化代码覆盖率报告。

生成 HTML 结果报告的步骤如下：

# 1. 生成 coverage.info 数据文件 lcov --capture --directory . --output-file coverage.info # 2. 根据这个数据文件生成报告 genhtml coverage.info --output-directory out 

删除所有生成的文件

上传过程中所有生成的文件可通过执行 make clean 命令来彻底删除掉。

make clean 命令的输出

sh-4.2$ make clean rm -rf main *.o *.so *.gcno *.gcda *.gcov coverage.info out 

代码覆盖率报告

首页以目录结构显示

进入目录后，显示该目录下的源文件

蓝色表示这些语句被覆盖

红色表示没有被覆盖的语句

LCOV 支持语句、函数和分支覆盖度量。

旁注：

• 还有另外一个生成 HTML 报告的工具叫 gcovr[6]，使用 Python 开发的，它的报告在显示方式上与 LCOV 略有不同。比如 LCOV 以目录结构显示， gcovr 以文件路径来显示，前者与代码结构一直因此我更倾向于使用前者。

不要高估代码覆盖率指标

代码覆盖率不是灵丹妙药，它只是告诉我们有哪些代码没有被测试用例“执行到”而已，高百分比的代码覆盖率不等于高质量的有效测试。

首先，高代码覆盖率不足以衡量有效测试。相反，代码覆盖率更准确地给出了代码未被测试程度的度量。这意味着，如果我们的代码覆盖率指标较低，那么我们可以确定代码的重要部分没有经过测试，然而反过来不一定正确。具有高代码覆盖率并不能充分表明我们的代码已经过充分测试。

其次，100% 的代码覆盖率不应该是我们明确努力的目标之一。这是因为在实现 100% 的代码覆盖率与实际测试重要的代码之间总是需要权衡。虽然可以测试所有代码，但考虑到为了满足覆盖率要求而编写更多无意义测试的趋势，当你接近此限制时，测试的价值也很可能会减少。

借 Martin Fowler 在这篇测试覆盖率[7]的文章说的一句话：

代码覆盖率是查找代码库中未测试部分的有用工具，然而它作为一个数字说明你的测试有多好用处不大。