0

0

c++中如何使用CMake构建项目_CMake项目构建流程指南

下次还敢

下次还敢

发布时间:2025-09-20 14:44:01

|

764人浏览过

|

来源于php中文网

原创

CMake通过CMakeLists.txt生成跨平台构建文件,基本流程包括:创建项目结构,编写配置文件设置标准与目标,外部构建目录运行cmake生成Makefile或IDE项目,编译链接可执行文件,支持依赖管理、安装测试及多平台扩展。

c++中如何使用cmake构建项目_cmake项目构建流程指南

CMake 是一个跨平台的构建系统生成器,广泛用于 C++ 项目中。它通过 CMakeLists.txt 文件描述项目的构建逻辑,并生成适用于不同编译环境(如 Make、Ninja、Visual Studio 等)的构建文件。下面介绍如何使用 CMake 构建 C++ 项目的基本流程。

1. 准备项目结构

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

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

在项目根目录下创建 CMakeLists.txt 文件,这是 CMake 的核心配置文件

2. 编写 CMakeLists.txt

在项目根目录的 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
)

包含头文件目录

target_include_directories(${PROJECT_NAME} PRIVATE include)

说明:

  • cmake_minimum_required:指定所需最低 CMake 版本。
  • project:定义项目名称和使用的语言。
  • set(CMAKE_CXX_STANDARD ...):设置 C++ 标准为 C++17。
  • add_executable:将源文件编译成可执行程序。
  • target_include_directories:为目标添加头文件搜索路径。

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

CMake 推荐使用“外部构建”方式,避免生成文件污染源码目录。

在项目根目录执行以下命令:

mkdir build
cd build
cmake ..

这会读取上级目录的 CMakeLists.txt 并生成对应的构建系统文件(如 Makefile)。

如果想使用 Ninja 生成器:

cmake -G "Ninja" ..

4. 编译项目

生成构建文件后,开始编译:

cmake --build .

等价于在 Makefile 环境下执行 make,在 Ninja 下执行 ninja。

编译成功后,可在 build 目录下看到生成的可执行文件(如 MyProject 或 MyProject.exe)。

小鸽子助手
小鸽子助手

一款集成于WPS/Word的智能写作插件

下载

5. 处理依赖库(以第三方头文件或静态库为例)

若项目依赖外部库,例如使用 fmt格式化输出

方法一:使用 find_package(适用于已安装的库)

find_package(fmt REQUIRED CONFIG)
target_link_libraries(${PROJECT_NAME} PRIVATE fmt::fmt)

方法二:直接包含源码或预编译库

# 假设库放在 external/fmt
add_subdirectory(external/fmt)
target_link_libraries(${PROJECT_NAME} PRIVATE fmt)

确保 external/fmt 中有 CMakeLists.txt 支持子目录构建。

6. 生成 IDE 项目文件

CMake 可生成 Visual Studio 或 Xcode 项目:

# 生成 Visual Studio 2022 解决方案
cmake -G "Visual Studio 17 2022" ..


生成 Xcode 项目

cmake -G "Xcode" ..

生成后可用对应 IDE 打开 .sln 或 .xcodeproj 文件进行开发。

7. 安装与测试(可选)

添加安装规则:

install(TARGETS ${PROJECT_NAME}
DESTINATION bin)
install(DIRECTORY include/ DESTINATION include)

运行安装:

cmake --build . --target install

添加基本测试:

enable_testing()
add_test(NAME run_main COMMAND ${PROJECT_NAME})

运行测试:

ctest

基本上就这些。CMake 的优势在于跨平台和模块化,合理组织 CMakeLists.txt 能让项目更易维护和扩展。

相关专题

更多
Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

2

2026.01.14

php与html混编教程大全
php与html混编教程大全

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

13

2026.01.13

PHP 高性能
PHP 高性能

本专题整合了PHP高性能相关教程大全,阅读专题下面的文章了解更多详细内容。

22

2026.01.13

MySQL数据库报错常见问题及解决方法大全
MySQL数据库报错常见问题及解决方法大全

本专题整合了MySQL数据库报错常见问题及解决方法,阅读专题下面的文章了解更多详细内容。

18

2026.01.13

PHP 文件上传
PHP 文件上传

本专题整合了PHP实现文件上传相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.13

PHP缓存策略教程大全
PHP缓存策略教程大全

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

6

2026.01.13

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

2

2026.01.13

交互式图表和动态图表教程汇总
交互式图表和动态图表教程汇总

本专题整合了交互式图表和动态图表的相关内容,阅读专题下面的文章了解更多详细内容。

40

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

5

2026.01.13

热门下载

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

精品课程

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

共94课时 | 6.7万人学习

C 教程
C 教程

共75课时 | 4万人学习

C++教程
C++教程

共115课时 | 12.2万人学习

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

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