CMake通过CMakeLists.txt定义项目结构并生成构建系统。1. 创建CMakeLists.txt指定版本、项目名、C++标准及源文件;2. 外部构建:mkdir build && cd build && cmake .. && make;3. 多文件用set(SOURCES)或add_subdirectory管理模块;4. 链接库用find_package引入第三方库,target_link_libraries链接静态/动态库。

C++ 使用 CMake 构建项目是一种跨平台、高效且灵活的方式。CMake 不是编译器,也不是构建系统,而是用来生成构建系统(如 Makefile 或 Ninja)的工具。通过编写 CMakeLists.txt 文件,你可以定义项目的结构、源文件、依赖关系和编译选项,然后由 CMake 自动生成对应的构建脚本。
1. 准备 CMakeLists.txt 文件
每个 CMake 项目都需要一个名为 CMakeLists.txt 的配置文件,放在项目根目录下。它描述了如何构建项目。
示例:最简单的 C++ 项目结构- project/
- CMakeLists.txt
- main.cpp
CMakeLists.txt 内容:
cmake_minimum_required(VERSION 3.10) project(MyApp) set(CMAKE_CXX_STANDARD 14) add_executable(myapp main.cpp)
说明:
立即学习“C++免费学习笔记(深入)”;
- cmake_minimum_required:指定所需最低 CMake 版本。
- project:定义项目名称。
- set(CMAKE_CXX_STANDARD 14):设置 C++ 标准为 C++14,也可设为 17 或 20。
- add_executable:将源文件编译成可执行文件。
2. 创建构建目录并运行 CMake
推荐使用“外部构建”方式,避免生成文件污染源码目录。
在项目根目录下执行:
mkdir build cd build cmake .. make
解释:
- mkdir build:创建独立的构建目录。
- cmake ..:读取上级目录中的 CMakeLists.txt,生成 Makefile。
- make:调用构建系统编译项目,生成可执行文件 myapp。
3. 添加多个源文件或子目录
如果项目包含多个 .cpp 文件:
本文档主要讲述的是maven使用方法;Maven是基于项目对象模型的(pom),可以通过一小段描述信息来管理项目的构建,报告和文档的软件项目管理工具。Maven将你的注意力从昨夜基层转移到项目管理层。Maven项目已经能够知道 如何构建和捆绑代码,运行测试,生成文档并宿主项目网页。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
add_executable(myapp main.cpp utils.cpp helper.cpp)
或者使用变量简化:
set(SOURCES
main.cpp
utils.cpp
helper.cpp
)
add_executable(myapp ${SOURCES})
对于大型项目,可使用 add_subdirectory 拆分模块:
add_subdirectory(src) add_subdirectory(libs/mylib)
在子目录中也需提供各自的 CMakeLists.txt。
4. 链接库(静态/动态)
若需链接第三方库,例如 OpenCV 或自定义库:
find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})
add_executable(myapp main.cpp)
target_link_libraries(myapp ${OpenCV_LIBS})
对于本地静态库:
add_library(mymath STATIC math.cpp) target_link_libraries(myapp mymath)
这样 myapp 就会链接 mymath 静态库。
基本上就这些。掌握 CMake 能让你更轻松地管理复杂 C++ 工程,支持跨平台开发(Windows + MSVC,Linux + GCC,macOS + Clang),配合 IDE(如 VS Code、CLion)也能自动识别项目结构。只要写好 CMakeLists.txt,构建过程就会变得简单可靠。










