0

0

如何在CMake中为c++项目添加代码覆盖率(coverage)报告? (gcov/lcov)

冰火之心

冰火之心

发布时间:2026-01-10 15:08:03

|

189人浏览过

|

来源于php中文网

原创

启用编译器覆盖率支持需同时添加-fprofile-arcs和-ftest-coverage,禁用优化(-O0),链接时也要加-fprofile-arcs;运行测试生成.gcda后,用lcov过滤无关路径再用genhtml生成报告。

如何在cmake中为c++项目添加代码覆盖率(coverage)报告? (gcov/lcov)

启用编译器的覆盖率支持(-fprofile-arcs -ftest-coverage)

不加这两个编译选项,gcov 就无法生成覆盖率数据文件(.gcda),后续所有报告都是空的。CMake 默认不会开启,必须显式添加。

  • CXX_FLAGS 添加 -fprofile-arcs -ftest-coverage,注意:二者需同时存在,缺一不可
  • 必须禁用优化(-O0)或至少禁用内联(-fno-inline),否则函数调用会被优化掉,.gcda 数据会不完整甚至缺失
  • 链接时也要加 -fprofile-arcs,否则链接阶段可能丢弃覆盖率相关符号(尤其在使用 target_link_libraries 时容易遗漏)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fprofile-arcs -ftest-coverage -O0")
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fprofile-arcs")

确保测试运行后生成 .gcda 文件

.gcda 是运行时生成的二进制覆盖率数据,不是编译时产生的。如果没看到它们,大概率是测试没真正执行、程序提前退出,或工作目录不对。

  • 测试可执行文件必须实际运行(ctest 或直接 ./my_test),且正常退出(return 0exit(0));崩溃或被信号终止会导致 .gcda 写入不全
  • 运行路径要和编译路径一致(尤其是相对路径包含源码时),否则 gcov 找不到源文件,lcov 会跳过对应项
  • .gcda 默认生成在可执行文件所在目录,不是源码目录;若测试是 ctest 驱动,确认 ctest 的工作目录(可用 ctest -V 查看)

用 lcov 提取并过滤覆盖率数据

lcov 是封装 gcov工具,但直接跑 lcov --capture 会抓到系统库、第三方头文件甚至 C++ 标准库的覆盖数据,必须过滤。

TTSMaker
TTSMaker

TTSMaker是一个免费的文本转语音工具,提供语音生成服务,支持多种语言。

下载
  • 先用 lcov --capture --directory . --output-file coverage_base.info 抓原始数据
  • lcov --remove coverage_base.info '/usr/*' '*/test/*' '*/third_party/*' --output-file coverage_filtered.info 剔除无关路径(路径通配符需用单引号防 shell 展开)
  • 关键点:--directory . 指的是包含 .gcda 的目录,不是源码根目录;若 .gcdabuild/test/ 下,这里就得写 --directory build/test

生成 HTML 报告并检查路径映射

genhtml 依赖 .gcno(编译生成)、.gcda(运行生成)和源码路径三者能对齐。常见报错 “cannot open source file” 就是因为路径不匹配。

立即学习C++免费学习笔记(深入)”;

  • 运行 genhtml coverage_filtered.info --output-directory coverage_html
  • 如果页面里显示源码路径是 /home/user/project/src/foo.cpp,但本地实际是 ~/proj/src/foo.cpp,就需用 --prefix 修复:genhtml ... --prefix "/home/user/project" --replace "path/to/project"
  • CI 环境中建议在 lcov --capture 前加 lcov --initial --directory . --output-file coverage_base.info,避免基线污染(尤其多轮测试时)
CMake 本身不内置覆盖率逻辑,所有步骤都靠手动注入编译标志 + 外部命令串联。最容易漏的是链接器标志和运行时工作目录 —— 这两个一错,整个链路就静默失败,连 .gcda 都看不到。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python异步编程与Asyncio高并发应用实践
Python异步编程与Asyncio高并发应用实践

本专题围绕 Python 异步编程模型展开,深入讲解 Asyncio 框架的核心原理与应用实践。内容包括事件循环机制、协程任务调度、异步 IO 处理以及并发任务管理策略。通过构建高并发网络请求与异步数据处理案例,帮助开发者掌握 Python 在高并发场景中的高效开发方法,并提升系统资源利用率与整体运行性能。

36

2026.03.12

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

135

2026.03.11

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

47

2026.03.10

Kotlin Android模块化架构与组件化开发实践
Kotlin Android模块化架构与组件化开发实践

本专题围绕 Kotlin 在 Android 应用开发中的架构实践展开,重点讲解模块化设计与组件化开发的实现思路。内容包括项目模块拆分策略、公共组件封装、依赖管理优化、路由通信机制以及大型项目的工程化管理方法。通过真实项目案例分析,帮助开发者构建结构清晰、易扩展且维护成本低的 Android 应用架构体系,提升团队协作效率与项目迭代速度。

90

2026.03.09

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

102

2026.03.06

Rust内存安全机制与所有权模型深度实践
Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开,深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例,分析内存安全保障原理与零成本抽象优势,并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学,掌握在高性能与安全性并重场景中的工程实践能力。

226

2026.03.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

502

2026.03.04

AI安装教程大全
AI安装教程大全

2026最全AI工具安装教程专题:包含各版本AI绘图、AI视频、智能办公软件的本地化部署手册。全篇零基础友好,附带最新模型下载地址、一键安装脚本及常见报错修复方案。每日更新,收藏这一篇就够了,让AI安装不再报错!

170

2026.03.04

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

286

2026.03.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

AngularJS教程
AngularJS教程

共24课时 | 4.1万人学习

CSS教程
CSS教程

共754课时 | 42.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号