
在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)project(MyApp VERSION 1.0 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_executable(${PROJECT_NAME} src/main.cpp src/utils.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. 构建项目
推荐使用外部构建(out-of-source),避免生成文件污染源码目录。
进入项目目录并执行:
mkdir build cd build cmake .. cmake --build .
这将在 build 目录中生成构建系统文件,并编译出可执行程序 MyApp。
本文档主要讲述的是maven使用方法;Maven是基于项目对象模型的(pom),可以通过一小段描述信息来管理项目的构建,报告和文档的软件项目管理工具。Maven将你的注意力从昨夜基层转移到项目管理层。Maven项目已经能够知道 如何构建和捆绑代码,运行测试,生成文档并宿主项目网页。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
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)
使用 gtest 进行测试
enable_testing()
add_executable(test_main test/test.cpp)
target_link_libraries(test_main gtest_main)
add_test(NAME test_all COMMAND test_main)
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,合理划分模块,灵活应对不同平台和依赖。









