，用于构建、测试和打包软件。

在 C++ 开发中，跨平台一直是个挑战——不同操作系统或硬件环境往往需要使用不同的本地构建工具，例如 Linux 常用的 Makefile、高效的 Ninja、Windows 上的 Visual Studio 项目文件（

）等。这些工具各自有独特的配置格式和运行机制，导致同一套源代码要为不同平台维护多份构建脚本，既费时又容易出错。

CMake 提出了一个新的思路，它的核心想法是：

用一套统一的CMake脚本描述构建规则

，再由它自动生成适合各平台的本地构建文件。这样开发者只需编写一套 

 文件，在其中声明源码位置、依赖关系、编译选项等信息；CMake 会根据目标平台输出对应的 Makefile、Ninja 文件或 Visual Studio 解决方案等。这样，软件就能在 Windows、Android、iOS、Linux 以及高性能计算集群等不同环境中顺利编译和运行。

，把通用的构建描述转换成各种本地工具能识别的格式，从而大幅降低多平台开发的复杂度。

CMake 支持多种目标构建系统，包括 Visual Studio、Xcode、ninja、make 和 VSCode。它使项目能够充分发挥其最重要的资源——开发者的潜力。由于 CMake 支持许多流行的 C++ IDE 系统以及命令行构建工具，开发者可以选择最符合自身需求的构建工具。

CMake 具有精确的依赖关系管理功能，并且只允许对已更改的代码进行最小程度的重新构建。它还支持 Fortran 和 C++ 模块。CMake 允许使用外部源代码进行构建，并且允许每个源代码树拥有多个构建树。

现代 CMake 允许将构建过程指定为一组目标（可执行文件、库、自定义命令）。每个目标都定义了它直接依赖的其他目标。然后，CMake 会按照正确的顺序执行构建，并包含传递链接目标。每个 CMake 构建树都包含一个缓存文件，其中包含构建过程中设置的变量。这些变量包括系统自省发现的所有内容、已安装软件的路径以及构建过程中使用的标志。CMake 提供了多个图形用户界面 (GUI)，允许用户编辑此缓存文件。

CMake 包含 CPack 系统，该系统允许创建适用于 Linux、Windows 和 Mac 的跨平台安装程序。

CMake 包含一个完整的跨平台安装系统。使用同一套命令，即可在 Linux、Windows 和 Mac 上安装软件包。

CMake 包含一个完整的跨平台测试系统。测试可以在项目的 CMake 源代码中指定，并在构建完成后运行。然后使用 CTest 运行这些测试。测试结果可以发送到 CDash，并且可以并行运行。

除了构建标准库和可执行文件外，CMake 还允许在构建时运行任意命令。这使得代码生成工具能够跨平台集成。

CMake 实现了调试适配器协议，可以使用第三方工具交互式地调试项目的 CMake 代码。

一般我们通过编写 CMakeLists.txt 做为一个项目的开始。

CMakeLists 文件可以在任何文本编辑器中编辑。

在任何受支持的生成器（Makefile、Visual Studio 等）中，如果您编辑了 CMakeLists 文件并重新构建，系统会自动调用 CMake 来更新生成的文件（例如 Makefile 或项目文件）。

这有助于确保生成的文件始终与 CMakeLists 文件保持同步。

CMake 语言来编写，CMake 语言由注释、命令和变量组成。

编写 CMakeLists.txt → 运行 cmake 配置 → 生成构建文件 → 编译。

为了简化配置过程，我们也常常把配置文件预先写到一个文件中，这个文件就叫做 CMakePresets.json 文件。

首先我们看看如何使用 CMake 来生成 Makefile 和构建项目。

和构建两个阶段，生成构建就是直接 cmake 就行。

构建需要加上 --build 这个参数。

# 在 build 目录生成 Makefile
cmake -S . -B build
# 等效传统命令：mkdir build && cd build && cmake ..

# 编译
cmake --build build
# 等效传统命令：cd build && make

# 配置Debug版本
cmake -S . -B build/debug -DCMAKE_BUILD_TYPE=Debug

# 编译Debug版本
cmake --build build/debug

# 配置Release版本
cmake -S . -B build/release  -DCMAKE_BUILD_TYPE=Release  -DCMAKE_CXX_FLAGS="-O3"

# 编译Release版本
cmake --build build/release

注释就是用来说明和解释CMake脚本的，实际不会执行的文本。

CMake 使用 # 进行行注释，可以放在任何位置。

# 这是一个 CMakeLists.txt 文件
cmake_minimum_required(VERSION 3.20)

CMake 使用 #[[  ]] 形式进行块注释。

#[[ 这是一个 CMakeLists.txt 文件。
这是一个 CMakeLists.txt 文件
这是一个 CMakeLists.txt 文件]]
cmake_minimum_required(VERSION 3.20)

命令由命令名称、左括号、以空格分隔的参数和右括号组成。

命令名称(参数1 参数2 ...)  # 参数间用空格分隔，整体用括号包裹

我们来写一个最小的项目。让我们开始编写一个游戏，这个游戏起名星际争霸。

首先，让我们建立一个 startcraft001的目录

startcraft001/
├── main.cpp
├── CMakeLists.txt
└── CMakePresets.json

这是主执行文件。程序很简单，就是输出一句话。

#include 

int main() {
    std::cout << "Start StartCraft!" << std::endl;
    return 0;
}

这三行配置定义了CMake项目的“最小骨架”：

cmake_minimum_required(VERSION 3.20)
project(StartCraft001)

# 添加可执行文件
add_executable(startcraft main.cpp)

cmake_minimum_required  
cmake最小需要的版本命令
这行说明当前项目至少需要3.20版本的CMake才能正确解析和执行后续配置。
cmake_minimum_required是CMake的内置命令。
VERSION是参数关键字（指定检查的是版本号）。
3.20是要求的最低CMake版本。
若执行配置的CMake版本低于3.20（比如在旧服务器上用了3.19），CMake会直接报错并终止，避免后续因版本不兼容导致的隐藏错误（比如新版本CMake引入的命令旧版本不支持）。
若版本等于或高于3.20，则继续往下执行配置——这是CMake项目的“安全门”，保证基础环境满足要求。

这行是项目名称定义命令，用于给当前 CMake 项目命名，并初始化一系列与项目相关的变量。
project 是 CMake 的核心命令，StartCraft001 是自定义的项目名称（可任意取名，建议见名知意）。
实际作用定义项目身份：CMake会将项目名称记录为项目的“标识”，部分工具（如IDE）会读取这个名称显示在项目窗口中。
执行该行后，CMake会自动创建多个与项目强关联的变量，常用的有：
PROJECT_NAME：存储项目名称（此处值为StartCraft001）；
CMAKE_PROJECT_NAME：全局生效的项目名称（多项目嵌套时更清晰）；
_SOURCE_DIR：项目源码根目录的路径
（此处为StartCraft001_SOURCE_DIR，即包含CMakeLists.txt的文件夹路径）；
_BINARY_DIR：项目构建输出目录的路径
（即编译生成的文件存放位置，如build文件夹）。
这些变量后续可用于简化路径引用（比如避免硬编码绝对路径）。

这行是生成可执行文件的核心指令，告诉CMake：“将指定的源文件编译链接为一个名为startcraft的可执行程序”。
add_executable是CMake的编译链接命令，包含两个关键参数：
第一个参数startcraft：最终生成的可执行文件名
（Windows下会自动加.exe后缀，即startcraft.exe；Linux/macOS下无后缀，直接是startcraft）；
第二个参数main.cpp：需要编译的源文件路径
（此处假设main.cpp与CMakeLists.txt在同一目录下，若为其他路径需写相对/绝对路径，如src/main.cpp）。
扩展说明：
若项目有多个源文件（比如a.cpp、b.cpp），只需在main.cpp后依次列出，或用空格分隔批量添加：
add_executable(startcraft main.cpp a.cpp b.cpp)；
CMake会自动处理依赖关系：
若main.cpp中包含了其他头文件（如myheader.h），只要头文件路径在CMake的搜索范围内（或通过include_directories指定），CMake会确保编译时正确找到头文件，无需手动添加到add_executable中（头文件不参与编译，仅参与语法检查）。

cmake --list-presets
# 输出
Configure presets:
  "debug"
  "release"

Build presets:
  "build-debug"
  "build-release"

cmake的配置阶段主要读取 CMakeLists.txt，生成 Makefile、build.ninja 等构建文件

# 配置 debug 版本
cmake --preset=debug

# 配置 release 版本
cmake --preset=release

cmake -S . -B build/debug -DCMAKE_BUILD_TYPE=Debug

cmake -S . -B build/release -DCMAKE_BUILD_TYPE=Release

cmake -S . -B build/debug -DCMAKE_BUILD_TYPE=Debug
│        │   │           │   └── 设置变量：构建类型=调试
│        │   │           └── 构建目录：build/debug
│        │   └── 源码目录：当前目录
│        └── CMake 命令

# 构建 debug 版本
cmake --build --preset=build-debug

# 构建 release 版本
cmake --build --preset=build-release

https://xplaza.cn/xingkong1983/cmake-tutorial.git

我们用 vscode 打开 starcraft001 后，可以选择 debug 。 

如果需要调试代码，可以在main.cpp 中点击 Debug, vscode 会自动为你生成一个 launch.json , 

好了，初级篇就到这里，中级篇我们主要讲讲如何编译库和调用库，并在顶层设计进行引用。

CMake 是一套开源、跨平台的工具集，用于构建、测试和打包软件。在 C++ 开发中，跨平台一直是个挑战——不同操作系统或硬件环境往往需要使用不同的本地构建工具，例如 Linux 常用的 Makefile、高效的 Ninja、Windows 上的 Visual Studio 项目文件（.sln）等。这些工具各自有独特的配置格式和运行机制，导致同一套源代码要为不同平台维护多份构建脚本，既费时又容易出错。如何解决这个问题呢？CMake 提出了一个新的思路，它的核心想法是：用一套统一的CMake脚本描述构建规则，再由它自动生成适合各平台的本地构建文件。这样开发者只需编写一套 CMakeLists.txt 文件，在其中声明源码位置、依赖关系、编译选项等信息；CMake 会根据目标平台输出对应的 Makefile、Ninja 文件或 Visual Studio 解决方案等。这样，软件就能在 Windows、Android、iOS、Linux 以及高性能计算集群等不同环境中顺利编译和运行。简言之，CMake 相当于一个跨平台构建系统的“翻译器”，把通用的构建描述转换成各种本地工具能识别的格式，从而大幅降低多平台开发的复杂度。

C++ 大型工程基础 - CMake教程（初级）

CMake 是一套开源、跨平台的工具集，用于构建、测试和打包软件。今天我们主要讲讲 CMake 的主要工作流程，并开发一个简单应用来验证流程。

编程语言

开发工具

后端

CMake是一款跨平台的开源构建工具，支持生成Makefile、Ninja、Visual Studio等多种构建系统文件。通过编写CMakeLists.txt统一配置，可自动适配不同平台环境，简化C++项目多平台开发流程。CMake提供依赖管理、测试系统、安装打包等功能，支持Windows/Linux/macOS等系统，大幅提升开发效率。

高性能计算集群

代码生成工具

Visual Studio

服务器

调试器

Android

Windows

Linux

Xcode

2026新春采购季

thpc

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

CMake是一款跨平台的开源构建工具，支持生成Makefile、Ninja、Visual Studio等多种构建系统文件。通过编写CMakeLists.txt统一配置，可自动适配不同平台环境，简化C++项目多平台开发流程。CMake提供依赖管理、测试系统、安装打包等功能，支持Windows/Linux/macOS等系统...

C++ 大型工程基础 - CMake教程（初级）

C++ 大型工程基础 - CMake教程（初级）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐