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/ 目录下看到生成的可执行程序。

ReRoom AI
ReRoom AI

专为室内设计打造的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、自定义函数、导出配置等高级功能。

相关专题

更多
C++ 高级模板编程与元编程
C++ 高级模板编程与元编程

本专题深入讲解 C++ 中的高级模板编程与元编程技术,涵盖模板特化、SFINAE、模板递归、类型萃取、编译时常量与计算、C++17 的折叠表达式与变长模板参数等。通过多个实际示例,帮助开发者掌握 如何利用 C++ 模板机制编写高效、可扩展的通用代码,并提升代码的灵活性与性能。

10

2026.01.23

php远程文件教程合集
php远程文件教程合集

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

29

2026.01.22

PHP后端开发相关内容汇总
PHP后端开发相关内容汇总

本专题整合了PHP后端开发相关内容,阅读专题下面的文章了解更多详细内容。

21

2026.01.22

php会话教程合集
php会话教程合集

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

21

2026.01.22

宝塔PHP8.4相关教程汇总
宝塔PHP8.4相关教程汇总

本专题整合了宝塔PHP8.4相关教程,阅读专题下面的文章了解更多详细内容。

13

2026.01.22

PHP特殊符号教程合集
PHP特殊符号教程合集

本专题整合了PHP特殊符号相关处理方法,阅读专题下面的文章了解更多详细内容。

11

2026.01.22

PHP探针相关教程合集
PHP探针相关教程合集

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

8

2026.01.22

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

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

55

2026.01.22

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

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

9

2026.01.22

热门下载

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

精品课程

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

共94课时 | 7.4万人学习

C 教程
C 教程

共75课时 | 4.2万人学习

C++教程
C++教程

共115课时 | 13.5万人学习

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

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