0

0

c++怎么使用CMake来构建项目_c++项目CMake构建与配置教程

冰火之心

冰火之心

发布时间:2025-10-23 19:42:02

|

550人浏览过

|

来源于php中文网

原创

使用CMake可提升C++项目结构清晰度与跨平台编译便利性,适合初学者及中小型项目。2. 项目结构应包含CMakeLists.txt、src/源码与include/头文件目录。3. 根目录CMakeLists.txt需定义最低CMake版本、项目名、C++标准并添加可执行文件。4. 通过target_include_directories将头文件路径加入编译搜索范围。5. 建议创建外部build目录运行cmake ..与make命令,避免污染源码。6. 多个源文件可用file(GLOB)或显式列出方式添加,推荐后者以提高可控性。7. 依赖第三方库如OpenCV时,使用find_package查找并用target_link_libraries链接。8. 可通过-DCMAKE_BUILD_TYPE=Debug或Release指定构建模式以适配开发或发布需求。掌握上述内容即可有效管理多数C++项目构建流程。

c++怎么使用cmake来构建项目_c++项目cmake构建与配置教程

使用CMake构建C++项目可以让项目结构更清晰,跨平台编译更容易。下面是一个实用的C++项目CMake构建与配置教程,适合初学者和中小型项目。

1. 准备项目结构

一个典型的C++项目结构如下:

my_project/
├── CMakeLists.txt
├── src/
│ └── main.cpp
└── include/
└── my_header.h

这个结构将源代码(src)、头文件(include)和构建配置(CMakeLists.txt)分开管理,便于维护。

2. 编写根目录的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(my_app src/main.cpp)

说明:

  • cmake_minimum_required:指定所需最低CMake版本。
  • project:定义项目名称和使用的语言(CXX代表C++)。
  • set(CMAKE_CXX_STANDARD ...):设置C++标准为C++17,也可改为14或20。
  • add_executable:将源文件编译为名为 my_app 的可执行程序。

3. 包含头文件目录

如果你的项目使用了自定义头文件,需要让编译器知道头文件路径。在 CMakeLists.txt 中添加:

target_include_directories(my_app PRIVATE include)

这行代码告诉编译器,在编译 my_app 时,把 include/ 目录加入搜索路径。PRIVATE 表示这个包含只用于该项目本身。

4. 创建构建目录并运行CMake

建议使用外部构建目录,避免生成文件污染源码。在项目根目录执行:

mkdir build
cd build
cmake ..
make

说明:

  • mkdir build:创建构建目录。
  • cmake ..:读取上级目录的 CMakeLists.txt 并生成 Makefile。
  • make:编译项目,生成可执行文件 my_app。

完成后可在 build/ 目录下看到生成的可执行程序。

皮卡智能
皮卡智能

AI驱动高效视觉设计平台

下载

5. 添加多个源文件

如果项目有多个cpp文件,比如:

src/
├── main.cpp
├── utils.cpp
└── helper.cpp

可以这样修改 CMakeLists.txt:

file(GLOB SOURCES "src/*.cpp")
add_executable(my_app ${SOURCES})

或者显式列出:

add_executable(my_app
src/main.cpp
src/utils.cpp
src/helper.cpp
)

推荐显式列出,避免意外包含不需要的文件。

6. 使用第三方库(以OpenCV为例)

若项目依赖外部库,如OpenCV,可这样配置:

find_package(OpenCV REQUIRED)
target_link_libraries(my_app PRIVATE ${OpenCV_LIBS})

确保系统已安装OpenCV,并且CMake能找到它。编译时会自动链接所需库。

对于通过包管理器(如vcpkg、conan)安装的库,CMake通常能自动识别路径。

7. 调试与发布模式

构建时可通过参数指定构建类型:

cmake .. -DCMAKE_BUILD_TYPE=Debug
cmake .. -DCMAKE_BUILD_TYPE=Release

Debug 模式包含调试信息,Release 模式开启优化。也可以在 IDE 中选择不同配置。

基本上就这些。掌握这些内容后,你已经可以使用CMake管理大多数C++项目了。随着项目变大,可以进一步学习子目录CMakeLists.txt、自定义函数、导出配置等高级功能。

相关专题

更多
菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

Golang 性能分析与pprof调优实战
Golang 性能分析与pprof调优实战

本专题系统讲解 Golang 应用的性能分析与调优方法,重点覆盖 pprof 的使用方式,包括 CPU、内存、阻塞与 goroutine 分析,火焰图解读,常见性能瓶颈定位思路,以及在真实项目中进行针对性优化的实践技巧。通过案例讲解,帮助开发者掌握 用数据驱动的方式持续提升 Go 程序性能与稳定性。

9

2026.01.22

html编辑相关教程合集
html编辑相关教程合集

本专题整合了html编辑相关教程合集,阅读专题下面的文章了解更多详细内容。

56

2026.01.21

三角洲入口地址合集
三角洲入口地址合集

本专题整合了三角洲入口地址合集,阅读专题下面的文章了解更多详细内容。

51

2026.01.21

AO3中文版入口地址大全
AO3中文版入口地址大全

本专题整合了AO3中文版入口地址大全,阅读专题下面的的文章了解更多详细内容。

397

2026.01.21

妖精漫画入口地址合集
妖精漫画入口地址合集

本专题整合了妖精漫画入口地址合集,阅读专题下面的文章了解更多详细内容。

118

2026.01.21

java版本选择建议
java版本选择建议

本专题整合了java版本相关合集,阅读专题下面的文章了解更多详细内容。

3

2026.01.21

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

16

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

11

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 7.3万人学习

C 教程
C 教程

共75课时 | 4.2万人学习

C++教程
C++教程

共115课时 | 13.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号