C++怎么使用CMake构建项目_C++工程管理与CMakeLists.txt编写

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C++怎么使用CMake构建项目_C++工程管理与CMakeLists.txt编写

2025-11-25

浏览次数：次

返回列表

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

c++怎么使用cmake构建项目_c++工程管理与cmakelists.txt编写

使用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示例：

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 build
cd build
cmake ..
cmake --build .

这会生成构建系统（如Makefile或Visual Studio工程），然后编译出可执行文件。输出文件通常位于build目录下。

美图云修

商业级AI影像处理工具

50 查看详情美图云修

添加多个源文件和子目录

如果项目变大，可以组织成模块。例如，在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引入，实现良好分层。