
在c++开发中,使用CMake可以高效地构建和管理跨平台项目。它不直接编译代码,而是根据配置生成适用于不同构建系统的文件(如Makefile、Ninja、visual studio项目等),从而实现灵活、可移植的构建流程。
1. 基本项目结构
一个典型的CMake C++项目通常包含以下结构:
my_project/ ├── CMakeLists.txt ├── src/ │ ├── main.cpp │ └── utils.cpp ├── include/ │ └── utils.h └── build/
根目录下的 CMakeLists.txt 是核心配置文件,用于定义项目信息、源文件、依赖和构建目标。
2. 编写 CMakeLists.txt
在项目根目录创建 CMakeLists.txt,内容如下:
立即学习“C++免费学习笔记(深入)”;
cmake_minimum_required(VERSION 3.10) <p>project(Myapp VERSION 1.0 LANGUAGES CXX)</p><p>set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON)</p><p>add_executable(${PROJECT_NAME} src/main.cpp src/utils.cpp )</p><p>target_include_directories(${PROJECT_NAME} PRIVATE include)</p>
说明:
- cmake_minimum_required:指定所需最低CMake版本。
- project:定义项目名称、版本和语言。
- set(CMAKE_CXX_STANDARD):设置C++标准为C++17。
- add_executable:将源文件编译为可执行文件。
- target_include_directories:为目标添加头文件搜索路径。
3. 构建项目
推荐使用外部构建(out-of-source),避免生成文件污染源码目录。
进入项目目录并执行:
mkdir build cd build cmake .. cmake --build .
这将在 build 目录中生成构建系统文件,并编译出可执行程序 MyApp。
4. 管理子目录与库
对于更复杂的项目,可以拆分为多个子目录。例如添加 lib/ 存放静态库:
my_project/ ├── CMakeLists.txt ├── src/ │ └── main.cpp ├── lib/ │ ├── CMakeLists.txt │ ├── utils.cpp │ └── include/utils.h └── build/
根目录 CMakeLists.txt 添加子目录:
add_subdirectory(lib) add_executable(MyApp src/main.cpp) target_link_libraries(MyApp PRIVATE UtilsLib)
lib/CMakeLists.txt 内容:
add_library(UtilsLib utils.cpp) target_include_directories(UtilsLib public include)
这里使用 PUBLIC 表示该头文件路径对链接此库的目标也生效。
5. 处理第三方依赖
使用 find_package 查找系统库,例如引入 Boost:
find_package(Boost REQUIRED COMPONENTS system filesystem) if(Boost_FOUND) target_link_libraries(MyApp PRIVATE ${Boost_LIBRARIES}) target_include_directories(MyApp PRIVATE ${Boost_INCLUDE_DIRS}) endif()
或者使用 FetchContent 自动下载依赖(需CMake 3.14+):
include(FetchContent) FetchContent_Declare( googletest URL https://github.com/google/googletest/archive/refs/tags/v1.14.0.zip ) FetchContent_MakeAvailable(googletest) <h1>使用 gtest 进行测试</h1><p>enable_testing() add_executable(test_main test/test.cpp) target_link_libraries(test_main gtest_main) add_test(NAME test_all COMMAND test_main)</p>
6. 常用构建选项
可通过命令行传递变量控制构建行为:
cmake -DCMAKE_BUILD_TYPE=Release .. cmake -DCMAKE_BUILD_TYPE=Debug .. cmake -DCMAKE_INSTALL_PREFIX=/usr/local ..
常用变量:
- CMAKE_BUILD_TYPE:构建类型(Debug, Release, RelWithDebInfo等)。
- CMAKE_INSTALL_PREFIX:安装路径前缀。
- CMAKE_CXX_COMPILER:指定C++编译器。
基本上就这些。掌握 CMake 的核心语法和项目组织方式后,就能高效管理从简单程序到大型项目的构建流程。关键是写好 CMakeLists.txt,合理划分模块,灵活应对不同平台和依赖。


