使用llvm-cov生成HTML覆盖率文件遇-format=html参数错误的解决方法

这个错误通常是因为你没跟上LLVM覆盖率工具的命令结构变化，或者参数格式用错了。下面分情况给你解决办法：

• 先确认你的LLVM版本
  先在终端运行llvm-cov --version查看版本号：

  • 如果是LLVM 9及以上版本：llvm-cov采用了子命令式结构，-format=html这种写法是错误的，而且长参数需要用双横线（--format=html），并且要配合show子命令使用。
  • 如果是LLVM 8及更早版本：工具没有show子命令，而是有专门的html子命令来生成HTML报告。

• 对应版本的正确命令示例

  1. LLVM 9+版本
     正确的命令结构如下：

     llvm-cov show --format=html -instr-profile=你的覆盖率数据.profdata 你的可执行文件路径 -o ./coverage-html
     

     各部分说明：

     • show：指定生成详细的覆盖率报告（如果要简洁汇总报告可以用report子命令，但report不支持HTML格式）
     • --format=html：指定输出格式为HTML（必须用双横线）
     • -instr-profile：指向你之前用llvm-profdata merge生成的.profdata文件
     • -o：指定HTML文件的输出目录，LLVM会自动生成一系列关联的HTML文件到这个目录里

  2. LLVM 8及更早版本
     直接用html子命令即可，不需要-format参数：

     llvm-cov html -instr-profile=你的覆盖率数据.profdata 你的可执行文件路径
     

     运行后会在当前目录生成HTML报告文件。

• 额外注意事项

  • 确保你已经正确生成了.profdata文件：如果只有.profraw文件，需要先合并：

    llvm-profdata merge -sparse 多个测试生成的.profraw -o 合并后的.profdata
    

  • 要是记不清参数，直接运行llvm-cov show --help（新版本）或者llvm-cov html --help（旧版本），就能看到完整的参数说明和示例。

内容的提问来源于stack exchange，提问作者Vlad Sahar