深入解读 CMakeLists.txt：从入门到精通 CMake 构建系统

  CMakeLists.txt 文件是 CMake 构建系统的核心配置文件，用于定义构建项目的步骤和参数。下面是对 CMakeLists.txt 文件的详细介绍，包括其基本语法和常用指令。

基本结构

一个典型的 CMakeLists.txt 文件包含以下部分：

1. 指定 CMake 版本

   cmake_minimum_required(VERSION 3.10)

   这行代码指定了所需的最低 CMake 版本。

2. 定义项目名称

   project(MyProject)

   这行代码定义了项目的名称 MyProject。

3. 添加源文件

   add_executable(MyProject main.cpp)

   这行代码添加了一个可执行文件 MyProject，并指定了其源文件 main.cpp。

常用指令

1. 设置 C++ 标准

   set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED True)

   这段代码设置了 C++ 标准为 C++17，并且要求该标准是必须的。

2. 添加包含目录

   include_directories(include)

   这行代码添加了包含目录 include。

3. 添加库文件

   add_library(MyLibrary STATIC mylibrary.cpp)

   这行代码添加了一个静态库 MyLibrary，其源文件为 mylibrary.cpp。

4. 链接库

   target_link_libraries(MyProject PRIVATE MyLibrary)

   这行代码将库 MyLibrary 链接到目标 MyProject。

5. 添加子目录

   add_subdirectory(src)

   这行代码添加了 src 子目录中的 CMake 文件。

6. 设置编译选项

   set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra")

   这行代码设置了编译选项。

示例 CMakeLists.txt 文件

以下是一个完整的示例 CMakeLists.txt 文件，展示了如何结合上述指令：

cmake_minimum_required(VERSION 3.10)

# 项目信息
project(MyProject VERSION 1.0 LANGUAGES CXX)

# 设置 C++ 标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED True)

# 包含目录
include_directories(include)

# 添加子目录
add_subdirectory(src)

# 添加库
add_library(MyLibrary STATIC src/mylibrary.cpp)

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

# 链接库
target_link_libraries(MyProject PRIVATE MyLibrary)

# 编译选项
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra")

# 安装目标
install(TARGETS MyProject DESTINATION bin)
install(FILES include/mylibrary.h DESTINATION include)

# 启用测试
enable_testing()
add_subdirectory(tests)

进一步阅读

要深入了解 CMakeLists.txt 的高级用法，可以参考 CMake 的官方文档和教程。以下是一些有用的资源：

•  CMake入门指南
• CMake官方文档
• CMake示例