CMake是跨平台构建系统生成器,通过CMakeLists.txt生成多平台构建文件。1. 安装:Linux用apt,macOS用brew,Windows从官网下载;2. 项目结构含src、include和CMakeLists.txt;3. 基本语法包括设置版本、项目名、C++标准及添加可执行文件;4. 推荐out-of-source构建,使用mkdir build、cmake ..、make编译;5. 配置头文件路径用target_include_directories,链接库用find_package和target_link_libraries;6. 支持条件判断处理跨平台差异,如WIN32、APPLE、UNIX;7. 现代CMake提倡target_*命令提升模块化;8. 可集成测试与安装规则,enable_testing()和install()实现自动化。掌握这些核心用法即可高效管理跨平台C++项目。

CMake 是一个强大的跨平台构建系统生成器,广泛用于 C++ 项目中。它不直接编译代码,而是根据 CMakeLists.txt 文件生成适用于不同平台的构建文件(如 Makefile、Visual Studio 工程等),从而实现“一次编写,多平台构建”。
1. 安装 CMake
在使用前需确保已安装 CMake:
-
Linux(Ubuntu/Debian):
sudo apt install cmake -
macOS:
brew install cmake - Windows:从 官网下载安装包,或使用 vcpkg、MSYS2 等工具安装
安装完成后,可通过以下命令验证:
cmake --version2. 基本项目结构
一个典型的 C++ 项目结构如下:
立即学习“C++免费学习笔记(深入)”;
my_project/
├── CMakeLists.txt
├── src/
│ └── main.cpp
└── include/
└── my_header.h
在项目根目录创建 CMakeLists.txt,内容如下:
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
)
说明:
-
cmake_minimum_required:指定所需最低 CMake 版本 -
project:定义项目名称和语言 -
set(CMAKE_CXX_STANDARD ...):启用 C++17 支持 -
add_executable:将源文件编译为可执行程序
3. 编译与运行项目
推荐使用 out-of-source 构建方式,避免污染源码目录:
mkdir build
cd build
cmake ..
make
生成后可在 build/ 目录下找到可执行文件 MyProject,运行:
./MyProject4. 添加头文件目录和库依赖
若项目包含头文件或第三方库,需配置包含路径:
target_include_directories(${PROJECT_NAME} PRIVATE
${PROJECT_SOURCE_DIR}/include
)
如果需要链接外部库(例如 Boost 或 OpenCV):
find_package(OpenCV REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE ${OpenCV_LIBS})
对于静态或动态库,可使用 add_library 创建:
add_library(mylib STATIC src/mylib.cpp)
target_include_directories(mylib PUBLIC include)
target_link_libraries(${PROJECT_NAME} PRIVATE mylib)
5. 跨平台兼容性处理
CMake 可自动识别平台并做条件判断:
if(WIN32)
message("Building on Windows")
add_compile_definitions(IS_WINDOWS)
elseif(APPLE)
message("Building on macOS")
elseif(UNIX)
message("Building on Linux")
endif()
也可针对不同构建类型(Debug/Release)设置编译选项:
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
add_compile_definitions(DEBUG_MODE)
endif()
6. 使用现代 CMake 最佳实践
现代 CMake 推荐使用 target_* 系列命令,而非全局设置:
-
target_include_directories():只为特定目标添加头文件路径 -
target_compile_features():指定目标所需的编译特性 -
target_link_libraries():精确控制库依赖传递
这样可以提升模块化程度,便于大型项目维护。
7. 集成测试与安装
启用测试功能:
enable_testing()
add_test(NAME run_main COMMAND MyProject)
设置安装规则:
install(TARGETS ${PROJECT_NAME}
DESTINATION bin
)
install(DIRECTORY include/
DESTINATION include
)
执行安装:
make install(可指定 CMAKE_INSTALL_PREFIX)
基本上就这些。CMake 功能丰富,但掌握基本语法后就能高效管理大多数 C++ 项目,尤其适合希望支持 Windows、Linux 和 macOS 的跨平台开发场景。











