CMake是跨平台C++构建工具,通过CMakeLists.txt配置项目;2. 典型项目结构包含src、include和CMakeLists.txt;3. 基本配置包括设置CMake最低版本、项目名、C++标准及源文件编译;4. 推荐在build目录中执行cmake ..和cmake --build .进行编译;5. 使用target_include_directories添加头文件路径,find_package和target_link_libraries引入外部库;6. 通过add_library定义自定义库并链接;7. 大型项目可用add_subdirectory实现模块化管理;8. CMake提升项目组织效率与跨平台兼容性。

在C++项目开发中,CMake 是一个跨平台的构建系统生成器,能够帮助开发者管理编译流程。相比直接使用 Makefile,CMake 更加灵活、可读性更强,支持多平台(Windows、Linux、macOS)和多种编译器(GCC、Clang、MSVC)。下面介绍如何使用 CMake 构建和管理 C++ 项目。
创建基本的 CMake 项目结构
一个典型的 C++ 项目目录结构如下:
my_project/├── CMakeLists.txt
├── src/
│ └── main.cpp
└── include/
└── my_header.h
在项目根目录下创建 CMakeLists.txt 文件,这是 CMake 的核心配置文件。
最简单的 CMakeLists.txt 内容如下:
立即学习“C++免费学习笔记(深入)”;
cmake_minimum_required(VERSION 3.10)project(MyProject LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_executable(${PROJECT_NAME}
src/main.cpp
)
说明:
- cmake_minimum_required:指定所需最低 CMake 版本。
- project:定义项目名称和使用的语言(CXX 表示 C++)。
- set(CMAKE_CXX_STANDARD ...):设置 C++ 标准为 C++17,可根据需要改为 14、20 等。
- add_executable:将源文件编译为可执行程序,程序名为项目名。
编译和运行项目
在项目根目录下执行以下命令进行构建:
mkdir buildcd build
cmake ..
cmake --build .
说明:
- mkdir build:创建独立的构建目录,避免污染源码目录(推荐做法)。
- cmake ..:在 build 目录中运行 CMake,读取上级目录的 CMakeLists.txt 并生成对应平台的构建文件(如 Makefile 或 Visual Studio 工程)。
- cmake --build .:调用底层构建工具(如 make 或 msbuild)完成编译。
构建成功后,可在 build 目录下找到生成的可执行文件 MyProject,直接运行即可。
本文档主要讲述的是maven使用方法;Maven是基于项目对象模型的(pom),可以通过一小段描述信息来管理项目的构建,报告和文档的软件项目管理工具。Maven将你的注意力从昨夜基层转移到项目管理层。Maven项目已经能够知道 如何构建和捆绑代码,运行测试,生成文档并宿主项目网页。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
添加头文件目录和库依赖
如果项目包含头文件或第三方库,需在 CMakeLists.txt 中声明路径。
例如,要让编译器能找到 include/ 目录下的头文件:
target_include_directories(${PROJECT_NAME} PRIVATE include)如果是链接外部库(如 OpenCV、Boost),可以这样写:
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)
支持子目录和模块化项目
大型项目通常按功能拆分目录。可以在每个子目录中放置单独的 CMakeLists.txt,并在主文件中使用 add_subdirectory 引入。
例如:
add_subdirectory(src/utils)add_subdirectory(src/network)
每个子目录中的 CMakeLists.txt 可以定义自己的库或可执行文件,实现模块化管理。
基本上就这些。掌握 CMake 能显著提升 C++ 项目的组织效率和跨平台能力。只要写好 CMakeLists.txt,一次配置,处处编译。










