news 2026/5/11 1:52:20

CMake 常用预设命令说明

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
CMake 常用预设命令说明

CMake 常用预设命令说明

在使用 CMake 构建 C/C++ 项目时,我们通常需要在CMakeLists.txt文件中定义一些基础设置,以确保项目能够在不同平台和编译器下正确构建。本文将介绍一些最常用的预设命令,包括指定 CMake 版本、设置编译模式、显示构建信息以及指定 C++ 标准等。


一、指定 CMake 的最小版本

CMakeLists.txt的开头,推荐使用以下命令指定所需的最低 CMake 版本:

cmake_minimum_required(VERSION 3.16)

该命令的作用是告诉 CMake,当前项目至少需要 3.16 版本才能正确运行。
如果使用了某些新特性(例如target_link_libraries的现代用法),而版本太低,就会在配置阶段报错。


二、定义项目名称及语言

定义项目名称和使用的编程语言:

project(MyProject LANGUAGES CXX)
  • MyProject是项目名称;
  • LANGUAGES可以指定C,CXX,CUDA,Fortran等;
  • 声明了语言后,CMake 会自动为该语言加载相应的规则和工具链。

三、设置编译模式(构建类型)

CMake 通常支持以下几种构建类型:

  • Debug—— 含有调试信息,不进行优化;
  • Release—— 开启优化,去除调试信息;
  • RelWithDebInfo—— 优化同时保留部分调试信息;
  • MinSizeRel—— 优化为最小体积。

可以通过以下方式设置默认的构建类型:

set(CMAKE_BUILD_TYPE Release)

💡 注意:

  • 在多配置生成器(如 Visual Studio、Xcode)中,CMAKE_BUILD_TYPE无效,需要在生成时选择配置。
  • 对于单配置生成器(如 Makefile、Ninja),上述变量才生效。

四、控制编译输出与信息显示

在开发调试中,可能需要输出更多的构建信息。CMake 提供了以下命令来控制消息显示:

message(STATUS "当前构建类型: ${CMAKE_BUILD_TYPE}") message(WARNING "这是一个警告信息") message(FATAL_ERROR "出现致命错误,终止配置")

常用的消息等级包括:

  • STATUS—— 普通状态信息;
  • WARNING—— 发出警告,不中断;
  • FATAL_ERROR—— 输出错误并停止执行。

此外,可通过命令行参数控制详细程度,例如:

cmake -DCMAKE_VERBOSE_MAKEFILE=ON..

这会让构建系统在编译时显示具体的命令行。


五、指定 C++ 标准版本

在现代 CMake 中,推荐使用以下语法来指定所需的 C++ 标准版本:

set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_CXX_EXTENSIONS OFF)

说明:

  • CMAKE_CXX_STANDARD指定 C++ 标准(如 11、14、17、20、23 等);
  • CMAKE_CXX_STANDARD_REQUIRED表示版本必须满足或高于指定标准;
  • CMAKE_CXX_EXTENSIONS OFF关闭编译器特有的扩展(如 GNU 扩展)。

六、典型的CMakeLists.txt示例

以下是一个简单示例,展示了本文中提到的关键命令:

cmake_minimum_required(VERSION 3.20) project(MyProject LANGUAGES CXX) # 设置构建类型 set(CMAKE_BUILD_TYPE Debug) # 指定 C++17 标准 set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_CXX_EXTENSIONS OFF) # 输出构建信息 message(STATUS "构建类型:${CMAKE_BUILD_TYPE}") message(STATUS "C++标准版本:${CMAKE_CXX_STANDARD}") # 添加源文件并生成可执行文件 add_executable(MyProject main.cpp)

运行命令构建项目:

cmake -B build -S.cmake --build build

七、总结

功能常用命令示例
指定 CMake 版本cmake_minimum_requiredcmake_minimum_required(VERSION 3.20)
定义项目projectproject(MyApp LANGUAGES CXX)
设置构建模式set(CMAKE_BUILD_TYPE ...)set(CMAKE_BUILD_TYPE Release)
输出信息message(STATUS ...)message(STATUS "构建类型:${CMAKE_BUILD_TYPE}")
C++ 标准版本set(CMAKE_CXX_STANDARD ...)set(CMAKE_CXX_STANDARD 17)
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/9 12:59:25

模拟电路偏置电路设计完整指南

模拟电路偏置设计:从基础到实战的完整路径你有没有遇到过这样的情况?一个精心设计的放大器,在仿真中表现完美,可一旦焊上板子,输出信号就开始漂移、失真,甚至完全无输出。排查半天电源、信号源都没问题——…

作者头像 李华
网站建设 2026/5/10 1:14:39

PMBus写保护机制在TI Fusion中的应用解析

PMBus写保护机制在TI Fusion中的实战解析:如何守护电源系统的“安全之门”你有没有遇到过这样的场景?系统运行得好好的,突然某次远程调试后,电源输出电压莫名其妙变了——不是代码改错了,也不是配置文件出问题&#xf…

作者头像 李华
网站建设 2026/5/9 16:39:08

案例征集活动发起:鼓励用户分享成功故事

案例征集:分享你的 Anything-LLM 实践故事 在企业知识库越来越庞大、员工查找信息却越来越难的今天,一个能“读懂文档”的AI助手早已不再是科幻场景。越来越多团队开始尝试将大语言模型引入内部系统,但真正落地时却发现:通用聊天…

作者头像 李华
网站建设 2026/5/9 8:00:22

资源大师软件绿化逆向永久方法

工具 MT管理器(看版本号选最新版本) NP管理器(看版本号选最新版本) 资源大师(自行必应) 教程 一、准备 1.在mt/np管理器提取安装包/找到安装包位置 2.去除软件签名效验,mt管理器中直接点击,np管理器中优先用超强方案2(去签…

作者头像 李华
网站建设 2026/5/9 8:00:21

手把手教程:基于LDO的电源管理芯片从零实现

从零构建一款LDO电源芯片:实战派模拟IC设计全解析 你有没有遇到过这样的场景? 在调试一个高精度ADC电路时,输出数据总是“跳码”;或者在射频前端供电中,信号频谱里莫名其妙多出几根杂散峰——排查到最后,问…

作者头像 李华