CMake通过CMakeLists.txt生成跨平台构建文件，基本流程包括：创建项目结构，编写配置文件设置标准与目标，外部构建目录运行cmake生成Makefile或IDE项目，编译链接可执行文件，支持依赖管理、安装测试及多平台扩展。

CMake 是一个跨平台的构建系统生成器，广泛用于 C++ 项目中。它通过 CMakeLists.txt 文件描述项目的构建逻辑，并生成适用于不同编译环境（如 Make、Ninja、Visual Studio 等）的构建文件。下面介绍如何使用 CMake 构建 C++ 项目的基本流程。

1. 准备项目结构

一个典型的 C++ 项目目录结构如下：

my_project/
├── CMakeLists.txt
├── src/
│ └── main.cpp
└── include/
└── my_header.h

在项目根目录下创建 CMakeLists.txt 文件，这是 CMake 的核心配置文件。

2. 编写 CMakeLists.txt

在项目根目录的 CMakeLists.txt 中写入以下内容：

立即学习“C++免费学习笔记（深入）”；

cmake_minimum_required(VERSION 3.10)
project(MyProject LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

添加可执行文件

add_executable(${PROJECT_NAME}
src/main.cpp
)

包含头文件目录

target_include_directories(${PROJECT_NAME} PRIVATE include)

说明：

• cmake_minimum_required：指定所需最低 CMake 版本。
• project：定义项目名称和使用的语言。
• set(CMAKE_CXX_STANDARD …)：设置 C++ 标准为 C++17。
• add_executable：将源文件编译成可执行程序。
• target_include_directories：为目标添加头文件搜索路径。

3. 创建构建目录并运行 CMake

CMake 推荐使用“外部构建”方式，避免生成文件污染源码目录。

在项目根目录执行以下命令：

mkdir build
cd build
cmake ..

这会读取上级目录的 CMakeLists.txt 并生成对应的构建系统文件（如 Makefile）。

如果想使用 Ninja 生成器：

cmake -G “Ninja” ..

4. 编译项目

生成构建文件后，开始编译：

cmake –build .

等价于在 Makefile 环境下执行 make，在 Ninja 下执行 ninja。

编译成功后，可在 build 目录下看到生成的可执行文件（如 MyProject 或 MyProject.exe）。

5. 处理依赖库（以第三方头文件或静态库为例）

若项目依赖外部库，例如使用 fmt 库格式化输出：

方法一：使用 find_package（适用于已安装的库）

find_package(fmt REQUIRED CONFIG)
target_link_libraries(${PROJECT_NAME} PRIVATE fmt::fmt)

方法二：直接包含源码或预编译库

# 假设库放在 external/fmt
add_subdirectory(external/fmt)
target_link_libraries(${PROJECT_NAME} PRIVATE fmt)

确保 external/fmt 中有 CMakeLists.txt 支持子目录构建。

6. 生成 IDE 项目文件

CMake 可生成 Visual Studio 或 Xcode 项目：

# 生成 Visual Studio 2022 解决方案
cmake -G “Visual Studio 17 2022” ..

生成 Xcode 项目

cmake -G “Xcode” ..

生成后可用对应 IDE 打开 .sln 或 .xcodeproj 文件进行开发。

7. 安装与测试（可选）

添加安装规则：

install(TARGETS ${PROJECT_NAME}
DESTINATION bin)
install(DIRECTORY include/ DESTINATION include)

运行安装：

cmake –build . –target install

添加基本测试：

enable_testing()
add_test(NAME run_main COMMAND ${PROJECT_NAME})

运行测试：

ctest

基本上就这些。CMake 的优势在于跨平台和模块化，合理组织 CMakeLists.txt 能让项目更易维护和扩展。