首先给出明确答案,CMake是C++项目中主流的构建系统生成工具,通过编写CMakeLists.txt文件生成跨平台构建文件。具体描述:文章介绍了CMake的基本使用流程,从环境准备、简单项目构建到多文件多目录管理,涵盖编译器与CMake安装验证、最小CMakeLists.txt编写、外部构建目录创建、静态库添加、C++标准设置及target_include_directories等现代CMake最佳实践,并指出其跨平台特性与扩展功能方向。顺序与原文一致,内容完整无截断。

C++项目管理中,CMake 是目前最主流的构建系统生成工具之一。它不直接编译代码,而是根据 CMakeLists.txt 文件生成适用于不同平台的构建文件(如 Makefile 或 Visual Studio 工程)。本文将带你从零开始编写一个简单的 CMakeLists.txt,快速上手 C++ 项目的 CMake 构建流程。
1. 准备工作:安装 CMake 和编译器
在使用 CMake 前,请确保你的系统已安装:
- 一个 C++ 编译器(如 GCC、Clang 或 MSVC)
- CMake(建议版本 3.10 以上)
可通过终端运行以下命令验证是否安装成功:
cmake --versiong++ --version
2. 创建最简单的 C++ 项目
假设你的项目结构如下:
立即学习“C++免费学习笔记(深入)”;
my_project/├── CMakeLists.txt
└── main.cpp
先创建 main.cpp:
#include iostream>int main() {
std::cout return 0;
}
然后创建同目录下的 CMakeLists.txt:
cmake_minimum_required(VERSION 3.10)project(MyProject)
add_executable(myapp main.cpp)
说明:
- cmake_minimum_required:指定所需最低 CMake 版本
- project:定义项目名称(可选添加 VERSION 和 LANGUAGES)
- add_executable:将源文件编译为可执行文件,myapp 是输出的程序名
3. 构建并运行项目
在项目根目录下打开终端,执行:
mkdir buildcd build
cmake ..
cmake --build .
解释:
- 创建 build 目录用于存放中间文件,避免污染源码(推荐做法)
- cmake .. 读取上级目录的 CMakeLists.txt 并生成构建系统
- cmake --build . 调用底层构建工具(如 make)编译项目
构建成功后,在 build 目录会生成可执行文件 myapp,运行它:
./myapp应输出:Hello from CMake!
4. 添加多个源文件和子目录
当项目变大时,通常会组织成多个源文件和子目录。例如:
my_project/├── CMakeLists.txt
├── main.cpp
├── src/
│ ├── math.cpp
│ └── math.h
└── include/
└── math.h
修改顶层 CMakeLists.txt:
cmake_minimum_required(VERSION 3.10)project(MyProject)
# 指定头文件搜索路径
include_directories(include)
# 添加可执行文件
add_executable(myapp main.cpp src/math.cpp)
如果你希望模块化管理 src 目录,可以添加子 CMakeLists.txt:
# my_project/src/CMakeLists.txtadd_library(math_lib STATIC math.cpp)
然后在主 CMakeLists.txt 中包含该目录:
cmake_minimum_required(VERSION 3.10)project(MyProject)
include_directories(include)
add_subdirectory(src)
add_executable(myapp main.cpp)
target_link_libraries(myapp math_lib)
这里使用了:
- add_subdirectory:包含子目录中的 CMakeLists.txt
- add_library(... STATIC):创建静态库
- target_link_libraries:将库链接到目标可执行文件
5. 设置 C++ 标准
现代 C++ 项目常使用 C++11/14/17/20。可在 CMakeLists.txt 中指定:
set(CMAKE_CXX_STANDARD 17)set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF) # 禁用编译器扩展(更标准)
或者针对特定目标设置(推荐):
target_compile_features(myapp PRIVATE cxx_std_17)6. 常见技巧与注意事项
- 始终使用 build 目录进行外部构建
- 使用 target_include_directories 替代全局 include_directories,更安全: target_include_directories(myapp PRIVATE include)
- 通过 cmake-gui 或 ccmake 查看和配置变量
- 跨平台时可用 if(MSVC) 或 if(UNIX) 分支处理差异
基本上就这些。掌握以上内容,你已经能用 CMake 管理大多数中小型 C++ 项目。随着项目复杂度上升,可进一步学习 find_package、自定义函数、导出配置等高级功能。CMake 虽语法略显独特,但一旦熟悉,其跨平台能力非常强大。










