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

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

尼克

发布： 2025-10-22 08:44:01

原创

686人浏览过

最小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配置基础的详细内容，更多请关注php中文网其它相关文章！