首页 > 后端开发 > C++ > 正文

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

下次还敢
发布: 2025-09-20 14:44:01
原创
753人浏览过
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)。

析稿Ai写作
析稿Ai写作

科研人的高效工具:AI论文自动生成,十分钟万字,无限大纲规划写作思路。

析稿Ai写作 142
查看详情 析稿Ai写作

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 能让项目更易维护和扩展。

以上就是c++++中如何使用CMake构建项目_CMake项目构建流程指南的详细内容,更多请关注php中文网其它相关文章!

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

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