使用CMake构建C++项目需先创建项目结构,编写CMakeLists.txt文件,设置最低版本、项目信息、C++标准,添加可执行目标并包含头文件路径,通过mkdir build; cd build; cmake ..; cmake --build .编译,支持多源文件管理与库链接。

使用CMake构建C++项目是现代C++开发中的常见做法。它能跨平台管理编译过程,让项目结构清晰、易于维护。下面介绍如何从零开始用CMake构建一个简单的C++工程,并编写合适的CMakeLists.txt文件。
创建基本项目结构
一个典型的C++项目目录结构如下:
my_project/├── CMakeLists.txt
├── src/
│ └── main.cpp
└── include/
└── my_header.h
首先在项目根目录创建CMakeLists.txt,这是CMake的配置核心文件。
编写CMakeLists.txt
以下是一个基础但完整的CMakeLists.txt示例:
立即学习“C++免费学习笔记(深入)”;
cmake_minimum_required(VERSION 3.10)project(MyProject VERSION 1.0 LANGUAGES CXX)
# 设置C++标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
# 包含头文件目录
target_include_directories(MyProject PRIVATE include)
# 添加可执行文件
add_executable(${PROJECT_NAME} src/main.cpp)
说明:
- cmake_minimum_required:指定所需最低CMake版本
- project:定义项目名称、版本和语言
- CMAKE_CXX_STANDARD:设置C++标准(如11、14、17、20)
- add_executable:将源文件编译为可执行程序
- target_include_directories:为目标添加头文件搜索路径
编译项目
在项目根目录执行以下命令:
mkdir buildcd build
cmake ..
cmake --build .
这会生成构建系统(如Makefile或Visual Studio工程),然后编译出可执行文件。输出文件通常位于build目录下。
添加多个源文件和子目录
如果项目变大,可以组织成模块。例如,在src下添加更多.cpp文件:
# 在CMakeLists.txt中列出所有源文件set(SOURCES
src/main.cpp
src/utils.cpp
src/logger.cpp
)
add_executable(${PROJECT_NAME} ${SOURCES})
也可以使用aux_source_directory自动收集源文件:
aux_source_directory(src SOURCES)add_executable(${PROJECT_NAME} ${SOURCES})
注意:这种方式不够精确,建议显式列出文件以提高可读性和控制力。
链接库文件
若需链接静态库或动态库,使用target_link_libraries:
add_library(mylib STATIC src/mylib.cpp)add_executable(app src/main.cpp)
target_link_libraries(app mylib)
对于第三方库,可用find_package查找:
find_package(OpenCV REQUIRED)target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS})
target_include_directories(${PROJECT_NAME} PRIVATE ${OpenCV_INCLUDE_DIRS})
基本上就这些。掌握CMake的关键是理解“目标”(target)的概念——每个可执行文件或库都是一个目标,通过target_开头的命令对其进行配置。随着项目增长,可以把子目录做成独立模块,用add_subdirectory引入,实现良好分层。









