CMake通过CMakeLists.txt生成跨平台构建文件。1. 项目结构包含src、include和CMakeLists.txt;2. 配置CMakeLists.txt设定版本、项目名、C++标准并添加可执行文件及头文件路径;3. 使用FetchContent集成Google Test等外部依赖;4. 外部构建:mkdir build、cmake ..、cmake --build .;5. IDE如CLion、VS Code、Visual Studio可自动识别CMakeLists.txt;6. 可选安装与打包:使用install命令和CPack生成发布包。

CMake 是一个跨平台的构建系统生成器,广泛用于 C++ 项目中。它不直接编译代码,而是根据 CMakeLists.txt 文件生成适用于不同编译环境的构建文件(如 Makefile、Visual Studio 工程等)。下面介绍使用 CMake 构建 C++ 项目的完整流程。
1. 准备项目结构
一个典型的 C++ 项目结构如下:
my_project/├── CMakeLists.txt
├── src/
│ └── main.cpp
└── include/
└── my_header.h
这种结构清晰分离源码、头文件和构建配置,便于维护。
2. 编写 CMakeLists.txt
在项目根目录创建 CMakeLists.txt,内容如下:
立即学习“C++免费学习笔记(深入)”;
cmake_minimum_required(VERSION 3.10)project(MyProject LANGUAGES CXX)
# 设置 C++ 标准
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++17 支持。
- add_executable:将源文件构建成可执行程序。
- target_include_directories:让编译器能找到头文件。
3. 外部依赖管理(以 Google Test 为例)
如果项目需要第三方库,可以用 FetchContent 自动下载并集成:
include(FetchContent)FetchContent_Declare(
googletest
URL https://github.com/google/googletest/archive/refs/tags/release-1.14.0.zip
)
FetchContent_MakeAvailable(googletest)
# 添加测试可执行文件
enable_testing()
add_executable(test_main test/test_main.cpp)
target_link_libraries(test_main gtest_main)
add_test(NAME test_main COMMAND test_main)
这样无需手动安装依赖,CMake 会自动处理。
4. 构建项目(命令行方式)
推荐使用外部构建(out-of-source),避免污染源码目录:
mkdir buildcd build
cmake ..
cmake --build .
解释:
- mkdir build:创建独立的构建目录。
- cmake ..:运行 CMake,读取上级目录的 CMakeLists.txt,生成构建系统文件。
- cmake --build .:调用底层构建工具(如 make 或 msbuild)编译项目。
构建成功后,可在 build 目录找到生成的可执行文件。
5. 使用 IDE(如 CLion、VS Code、Visual Studio)
现代 IDE 原生支持 CMake:
- CLion:打开项目文件夹即可自动识别 CMakeLists.txt。
- VS Code + CMake Tools 插件:按提示选择构建套件,点击“构建”按钮。
- Visual Studio:打开 CMakeLists.txt 文件,VS 会自动生成项目。
无需手动导入工程,IDE 会监听 CMakeLists.txt 变化并重新配置。
6. 安装与打包(可选)
若希望安装到系统目录或打包发布:
install(TARGETS ${PROJECT_NAME}DESTINATION bin)
install(DIRECTORY include/
DESTINATION include)
include(CPack)
然后运行:
cmake --install . --prefix /usr/localcpack
可生成 deb、rpm 或 zip 等格式的发布包。
基本上就这些。掌握以上流程,就能用 CMake 高效管理大多数 C++ 项目。关键是写好 CMakeLists.txt,保持项目结构清晰,构建过程就会很顺畅。










