c++如何编写一个CMakeLists.txt文件_c++项目CMake配置基础

最小CMake配置包括版本、项目名和可执行文件;2. 推荐用target_compile_features设置C++标准;3. 多源文件可手动列出或GLOB收集;4. 用target_include_directories添加头文件路径;5. target_link_libraries链接静态或系统库;6. 支持多构建模式并可定义编译宏;7. 示例展示库与可执行文件的组织方式。

c++如何编写一个cmakelists.txt文件_c++项目cmake配置基础

编写一个 CMakeLists.txt 文件是管理 C++ 项目构建过程的基础。CMake 是跨平台的构建系统生成器,通过它你可以定义项目的编译方式、依赖关系和输出目标。下面是一个从零开始配置 C++ 项目的 CMake 基础指南。

1. 最小可运行的 CMakeLists.txt

一个最简单的 C++ 项目只需要一个源文件和基本的 CMake 配置:

cmake_minimum_required(VERSION 3.10)

project(MyApp)

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

add_executable(myapp main.cpp)

说明:

cmake_minimum_required:指定所需最低 CMake 版本,避免使用旧版本导致兼容问题。project:定义项目名称(MyApp),会自动设置一些变量如 MyApp_BINARY_DIR。add_executable:将 main.cpp 编译为可执行文件 myapp。

2. 设置 C++ 标准和编译选项

现代 C++ 通常使用 C++17 或更高标准,需显式指定:

set(CMAKE_CXX_STANDARD 17)

set(CMAKE_CXX_STANDARD_REQUIRED ON)

set(CMAKE_CXX_EXTENSIONS OFF)

或者更推荐的方式,针对特定目标设置:

add_executable(myapp main.cpp)

target_compile_features(myapp PRIVATE cxx_std_17)

优点: target_compile_features 更精确,且支持不同目标使用不同标准。

3. 添加多个源文件

如果项目包含多个 .cpp 文件,可以列出所有源文件:

set(SOURCES

src/main.cpp

src/utils.cpp

src/logger.cpp

)

add_executable(myapp ${SOURCES})

也可以用 file(GLOB …) 自动收集源文件(适合小型项目):

file(GLOB SOURCES “src/*.cpp”)

add_executable(myapp ${SOURCES})

注意: GLOB 方式在文件增删后可能不会触发重新配置,建议手动列出或结合脚本使用。

4. 包含头文件目录

当头文件不在默认路径时,需要添加包含目录:

target_include_directories(myapp PRIVATE include)

PRIVATE 表示仅该目标内部使用;若其他项目依赖此目标并需要访问头文件,可用 INTERFACE 或 PUBLIC。

例如,include 目录结构如下:

myproject/├── CMakeLists.txt├── include/│ └── mylib.h└── src/ └── main.cpp

5. 链接库文件

若项目依赖静态库或动态库,使用 target_link_libraries:

add_executable(myapp main.cpp)

target_link_libraries(myapp PRIVATE some_library)

链接系统库(如 pthread):

target_link_libraries(myapp PRIVATE pthread)

如果是自己定义的库:

add_library(mylib STATIC src/mylib.cpp)

target_include_directories(mylib PUBLIC include)

add_executable(myapp main.cpp)

target_link_libraries(myapp PRIVATE mylib)

6. 调试与发布模式

CMake 默认支持多配置模式。可通过命令行指定:

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make

常用类型:Debug、Release、RelWithDebInfo、MinSizeRel。

在 Debug 模式下自动定义宏 DEBUG:

if(CMAKE_BUILD_TYPE STREQUAL “Debug”)

target_compile_definitions(myapp PRIVATE DEBUG)

endif()

7. 完整示例:带子目录的小型项目

假设项目结构如下:

.├── CMakeLists.txt├── include│ └── hello.h├── src│ ├── hello.cpp│ └── main.cpp

根目录 CMakeLists.txt:

cmake_minimum_required(VERSION 3.10)
project(HelloWorld VERSION 1.0)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 添加库
add_library(hello_lib STATIC
src/hello.cpp
)

# 导出头文件路径
target_include_directories(hello_lib PUBLIC
include
)

# 添加可执行文件
add_executable(app src/main.cpp)

# 链接库
target_link_libraries(app PRIVATE hello_lib)

基本上就这些。掌握这些基础后,可以逐步扩展到使用 findpackage 引入第三方库、创建安装规则、支持测试等高级功能。关键是理解 target* 系列命令的作用范围和现代 CMake 的“目标导向”理念。

以上就是c++++如何编写一个CMakeLists.txt文件_c++项目CMake配置基础的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1480303.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
c++如何获取类的类型信息RTTI_c++运行时类型识别RTTI用法
上一篇 2025年12月19日 04:31:05
c++如何连接两个字符串_c++字符串拼接多种实现方法
下一篇 2025年12月19日 04:31:12

相关推荐

发表回复

登录后才能评论
关注微信