0

0

C++如何使用CMake构建项目_C++ CMakeLists.txt编写入门教程

穿越時空

穿越時空

发布时间:2025-11-29 13:03:06

|

308人浏览过

|

来源于php中文网

原创

首先给出明确答案,CMake是C++项目中主流的构建系统生成工具,通过编写CMakeLists.txt文件生成跨平台构建文件。具体描述:文章介绍了CMake的基本使用流程,从环境准备、简单项目构建到多文件多目录管理,涵盖编译器与CMake安装验证、最小CMakeLists.txt编写、外部构建目录创建、静态库添加、C++标准设置及target_include_directories等现代CMake最佳实践,并指出其跨平台特性与扩展功能方向。顺序与原文一致,内容完整无截断。

c++如何使用cmake构建项目_c++ cmakelists.txt编写入门教程

C++项目管理中,CMake 是目前最主流的构建系统生成工具之一。它不直接编译代码,而是根据 CMakeLists.txt 文件生成适用于不同平台的构建文件(如 Makefile 或 Visual Studio 工程)。本文将带你从零开始编写一个简单的 CMakeLists.txt,快速上手 C++ 项目的 CMake 构建流程。

1. 准备工作:安装 CMake 和编译器

在使用 CMake 前,请确保你的系统已安装:

  • 一个 C++ 编译器(如 GCC、Clang 或 MSVC)
  • CMake(建议版本 3.10 以上)

可通过终端运行以下命令验证是否安装成功:

cmake --version
g++ --version

2. 创建最简单的 C++ 项目

假设你的项目结构如下:

立即学习C++免费学习笔记(深入)”;

my_project/
├── CMakeLists.txt
└── main.cpp

先创建 main.cpp

#include iostream>

int main() {
std::cout return 0;
}

然后创建同目录下的 CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(MyProject)

add_executable(myapp main.cpp)

说明:

  • cmake_minimum_required:指定所需最低 CMake 版本
  • project:定义项目名称(可选添加 VERSION 和 LANGUAGES)
  • add_executable:将源文件编译为可执行文件,myapp 是输出的程序名

3. 构建并运行项目

在项目根目录下打开终端,执行:

mkdir build
cd build
cmake ..
cmake --build .

解释:

  • 创建 build 目录用于存放中间文件,避免污染源码(推荐做法)
  • cmake .. 读取上级目录的 CMakeLists.txt 并生成构建系统
  • cmake --build . 调用底层构建工具(如 make)编译项目

构建成功后,在 build 目录会生成可执行文件 myapp,运行它:

VidAU
VidAU

VidAU AI 是一款AI驱动的数字人视频创作平台,旨在简化视频内容创作流程

下载
./myapp

应输出:Hello from CMake!

4. 添加多个源文件和子目录

当项目变大时,通常会组织成多个源文件和子目录。例如:

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

修改顶层 CMakeLists.txt:

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 指定头文件搜索路径
include_directories(include)

# 添加可执行文件
add_executable(myapp main.cpp src/math.cpp)

如果你希望模块化管理 src 目录,可以添加子 CMakeLists.txt:

# my_project/src/CMakeLists.txt
add_library(math_lib STATIC math.cpp)

然后在主 CMakeLists.txt 中包含该目录:

cmake_minimum_required(VERSION 3.10)
project(MyProject)

include_directories(include)
add_subdirectory(src)

add_executable(myapp main.cpp)
target_link_libraries(myapp math_lib)

这里使用了:

  • add_subdirectory:包含子目录中的 CMakeLists.txt
  • add_library(... STATIC):创建静态库
  • target_link_libraries:将库链接到目标可执行文件

5. 设置 C++ 标准

现代 C++ 项目常使用 C++11/14/17/20。可在 CMakeLists.txt 中指定:

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF) # 禁用编译器扩展(更标准)

或者针对特定目标设置(推荐):

target_compile_features(myapp PRIVATE cxx_std_17)

6. 常见技巧与注意事项

  • 始终使用 build 目录进行外部构建
  • 使用 target_include_directories 替代全局 include_directories,更安全:
  • target_include_directories(myapp PRIVATE include)
  • 通过 cmake-guiccmake 查看和配置变量
  • 跨平台时可用 if(MSVC)if(UNIX) 分支处理差异

基本上就这些。掌握以上内容,你已经能用 CMake 管理大多数中小型 C++ 项目。随着项目复杂度上升,可进一步学习 find_package、自定义函数、导出配置等高级功能。CMake 虽语法略显独特,但一旦熟悉,其跨平台能力非常强大。

相关专题

更多
if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

760

2023.08.22

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

338

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

542

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

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

53

2025.08.29

C++中int的含义
C++中int的含义

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

197

2025.08.29

unix和linux的区别
unix和linux的区别

unix和linux的区别包括发展历史、开源性、发行版本、内核、文件系统、应用程序兼容性和用户界面等。本专题为大家提供unix和linux相关的文章、下载、课程内容,供大家免费下载体验。

386

2023.09.22

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

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

9

2026.01.22

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

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

53

2026.01.21

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

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

28

2026.01.21

热门下载

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

精品课程

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

共94课时 | 7.3万人学习

C 教程
C 教程

共75课时 | 4.2万人学习

C++教程
C++教程

共115课时 | 13.4万人学习

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

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