新闻中心

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

2025-11-29
浏览次数:
返回列表
首先给出明确答案,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++ 项目

假设你的项目结构如下:

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

N世界 N世界

一分钟搭建会展元宇宙

N世界 138 查看详情 N世界 ./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 虽语法略显独特,但一旦熟悉,其跨平台能力非常强大。

以上就是C++如何使用CMake构建项目_C++ CMakeLists.txt编写入门教程的详细内容,更多请关注其它相关文章!


# 解决方法  # 抖音团伙如何做营销推广  # 社会化营销推广案例  # 湘乡营销推广招聘网  # 企业手机网站建设有效吗  # 百度seo转型做谷歌seo  # 福建seo引擎优化  # 扬州网络推广营销价格高  # 国网党建网站建设方案  # 网站建设简单点的  # 佛山贸易网站建设  # 所需  # 适用于  # 如果你  # 迭代  # c++  # 重写  # 多个  # 如何使用  # 有什么  # 可执行文件  # red  # stream  # ios  # unix  # ai  # 工具  # app  # cmake 


相关栏目: 【 科技资讯46185 】 【 网络学院92790


相关推荐: win11如何卸载Windows更新补丁 Win11解决更新导致系统不稳定的问题【修复】  C++的std::forward_list怎么用_C++ STL中单向链表容器的特点与应用  如何将HTML表格多行数据保存到Google Sheets  整合Supabase认证与Django模型:跨模式迁移的解决方案  LINUX下如何进行磁盘分区_fdisk与parted工具在LINUX中的使用对比  单射、满射与双射的关系 一文理清所有逻辑  QQ邮箱网页版入口页面 QQ邮箱在线登录入口官网  XML中包含HTML标签导致解析错误? 正确嵌入非XML数据的两种方法  mc.js官网登录入口 mc.js官方登录入口最新版  mc.js游戏直达 mc.js网页免下载版本秒进地址  Lar*el用户头像管理:实现图片缩放、存储与旧文件安全删除的最佳实践  12306怎么选座位选到安静区_12306选座安静区域选择策略  Win11怎么关闭快速启动_Win11彻底关机设置教程  mcjs网页版流畅运行 mcjs低配电脑畅玩入口  顺丰快递查单号物流信息 顺丰快递小程序查询入口  微信客户端如何收红包_微信客户端接收红包使用教程  windows10怎么查看硬盘序列号_windows10硬盘id查询命令  微信网页版扫码登录入口 微信网页版二维码登录入口  Win10快速启动功能利弊分析 Win10开启或关闭快速启动教程【技巧】  动漫共和国防屏蔽稳定域名-动漫共和国官方正版直达通道  C++ explicit关键字防止隐式转换_C++构造函数安全规范  Archive of Our Own官网直达 AO3最新可用地址一览  C++如何生成随机数_C++ random库使用方法与范围设置  J*a递归快速排序中静态变量导致数据累积问题的解决方案  NetBeans Ant项目:自动化将资源文件复制到dist目录的教程  处理动态列数据:J*a ArrayList的正确初始化与字符累加教程  sublime怎么进行远程开发编辑_配置rsub/rmate实现sublime编辑服务器文件  MongoDB Aggregation:在嵌套对象数组中精确匹配ObjectId  解决Tabulator日期时间排序问题的专业指南  如何将HTML表格多行数据保存到Google Sheet  探索高级语言到C/C++的转译路径:以Go为例及内存管理策略  Win11怎么设置鼠标主按键_Win11鼠标左右键功能互换  AO3最新入口2025公告_AO3中文官网合集  学习通在线学习平台 学习通网页版直接进入课程中心  c++ 获取系统当前时间 c++时间戳获取方法  qq邮箱日历功能怎么用_创建日程与会议邀请的技巧  Word2013如何插入视频和音频媒体_Word2013媒体插入的多媒体支持  地铁跑酷免费秒玩入口链接 地铁跑酷小游戏免费秒玩网站  React列表渲染与独立状态管理:避免全局状态影响局部更新  c++中的std::forward_list和std::list有什么不同_c++ forward_list与list区别分析  Go RPC HTTP服务正确实现与常见陷阱解析  c++20的std::jthread是什么_c++可中断线程与RAII式管理  C++20的source_location是什么_C++在编译期获取源码位置信息用于日志和断言  J*a里如何实现订单支付与库存同步功能_支付库存同步项目开发方法说明  在WordPress中通过REST API获取BasicAuth保护的远程文章  UC浏览器官网入口2025最新 UC浏览器网页版正式地址  晋江读书网页版在线登录 晋江读书电脑版官网  AO3镜像入口大全 AO3网页版内容访问全集  taptap防沉迷怎么解除 taptap解除健康系统限制说明【2025最新】  Win10怎么制作U盘启动盘 Win10系统安装U盘制作教程【详解】 

搜索