0

0

C++如何编写一个CMakeLists.txt文件?(多目录项目)

裘德小鎮的故事

裘德小鎮的故事

发布时间:2026-01-04 16:59:02

|

799人浏览过

|

来源于php中文网

原创

多目录C++项目需分层编写CMakeLists.txt:根目录定义项目、标准及add_subdirectory引入src/tests等子目录;src目录用add_library/add_executable构建目标并设头文件路径;tests目录启用enable_testing、添加测试可执行文件并注册add_test;include目录无需CMakeLists.txt,头文件路径通过target_include_directories暴露。

c++如何编写一个cmakelists.txt文件?(多目录项目)

多目录C++项目的CMakeLists.txt需要分层编写:根目录一个主文件负责项目配置和子目录管理,每个子目录(如srcincludetests)配一个独立的CMakeLists.txt负责局部构建逻辑。

根目录CMakeLists.txt:定义项目与包含子目录

这是整个项目的入口,必须放在最外层。核心是声明项目名、C++标准、最低CMake版本,并用add_subdirectory()引入各模块:

  • cmake_minimum_required(VERSION 3.10)明确最低CMake版本(推荐3.10或更高)
  • project(MyApp VERSION 1.0 LANGUAGES CXX)声明项目名、版本和语言
  • set(CMAKE_CXX_STANDARD 17)统一设置C++标准(可选,也可在target上单独设)
  • add_subdirectory(src)add_subdirectory(tests)逐个引入子目录
  • 若含第三方依赖,可在根目录用find_package()FetchContent提前准备

src/CMakeLists.txt:组织源码与生成可执行/库

该目录通常存放.cpp.h文件。这里用add_library()add_executable()定义构建目标:

  • file(GLOB_RECURSE SOURCES "*.cpp")可收集所有cpp(但更推荐显式列出,便于维护)
  • add_library(mylib STATIC ${SOURCES})创建静态库;用SHARED可建动态库
  • target_include_directories(mylib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/../include)导出头文件路径
  • 若生成可执行文件:add_executable(myapp main.cpp),再用target_link_libraries(myapp PRIVATE mylib)链接库

tests/CMakeLists.txt:单独管理测试代码

测试目录建议独立构建,避免污染主逻辑。常用做法是引入Google Test或使用CMake内置CTest:

Eclipse配置Tomcat教程 中文WORD版
Eclipse配置Tomcat教程 中文WORD版

本文档主要讲述的是Eclipse配置Tomcat教程;Eclipse IDE: eclipse IDE 用作 JSP 页面和 Java 文件的开发环境。Eclipse 是一个非常简单易用的 IDE 环境,它具有很多特性,可以帮助程序员快速编写并调试 Java 程序。加上 tomcat 插件之后,这个 IDE 就是管理整个 Web 项目(包括 HTML 和 JSP 页面、图标和 servlet)的一个非常优秀的工具。 Tomcat: 驱动 JSP 页面需要使用 Tomcat。Tomcat 引擎是非常好的一个

下载

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

  • 启用测试支持:enable_testing()(写在根目录或test目录均可,推荐根目录)
  • 添加测试可执行文件:add_executable(test_main test_main.cpp)
  • 链接测试库和主库:target_link_libraries(test_main PRIVATE mylib gtest_main)
  • 注册为CTest测试:add_test(NAME run_tests COMMAND test_main)
  • 若用FetchContent内嵌gtest,需在根目录或本目录中提前声明并include(FetchContent)

include/ 和其他目录:无需CMakeLists.txt(除非需生成安装规则)

include/目录本身不编译,一般不放CMakeLists.txt。头文件路径通过target_include_directories()暴露给对应target即可。如果要做install(如make install),可在根目录或src/中加:

  • install(TARGETS mylib EXPORT mylibTargets)导出库
  • install(DIRECTORY ../include/myapp/ DESTINATION include/myapp)安装头文件
  • install(EXPORT mylibTargets DESTINATION lib/cmake/myapp)生成配置文件供下游使用

不复杂但容易忽略:每个add_subdirectory()调用都会进入对应目录执行其CMakeLists.txt,变量作用域默认隔离(除非用PARENT_SCOPE显式传递),所以不要假设子目录能自动读到根目录的变量。

相关专题

更多
Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

37

2026.01.14

php与html混编教程大全
php与html混编教程大全

本专题整合了php和html混编相关教程,阅读专题下面的文章了解更多详细内容。

19

2026.01.13

PHP 高性能
PHP 高性能

本专题整合了PHP高性能相关教程大全,阅读专题下面的文章了解更多详细内容。

37

2026.01.13

MySQL数据库报错常见问题及解决方法大全
MySQL数据库报错常见问题及解决方法大全

本专题整合了MySQL数据库报错常见问题及解决方法,阅读专题下面的文章了解更多详细内容。

19

2026.01.13

PHP 文件上传
PHP 文件上传

本专题整合了PHP实现文件上传相关教程,阅读专题下面的文章了解更多详细内容。

16

2026.01.13

PHP缓存策略教程大全
PHP缓存策略教程大全

本专题整合了PHP缓存相关教程,阅读专题下面的文章了解更多详细内容。

6

2026.01.13

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

3

2026.01.13

交互式图表和动态图表教程汇总
交互式图表和动态图表教程汇总

本专题整合了交互式图表和动态图表的相关内容,阅读专题下面的文章了解更多详细内容。

45

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

9

2026.01.13

热门下载

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

精品课程

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

共32课时 | 3.7万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

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

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