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,运行它:

扣子编程
扣子编程

扣子推出的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 虽语法略显独特,但一旦熟悉,其跨平台能力非常强大。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

777

2023.08.22

string转int
string转int

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

443

2023.08.02

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

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

544

2024.08.29

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

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

93

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

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

24

2026.01.28

包子漫画在线官方入口大全
包子漫画在线官方入口大全

本合集汇总了包子漫画2026最新官方在线观看入口,涵盖备用域名、正版无广告链接及多端适配地址,助你畅享12700+高清漫画资源。阅读专题下面的文章了解更多详细内容。

7

2026.01.28

ao3中文版官网地址大全
ao3中文版官网地址大全

AO3最新中文版官网入口合集,汇总2026年主站及国内优化镜像链接,支持简体中文界面、无广告阅读与多设备同步。阅读专题下面的文章了解更多详细内容。

28

2026.01.28

热门下载

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

精品课程

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

共94课时 | 7.8万人学习

C 教程
C 教程

共75课时 | 4.3万人学习

C++教程
C++教程

共115课时 | 14.4万人学习

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

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