CMake 最小可跑实战：从 0 构建第一个 C++ 可执行程序（C++ 工程入门第二课）

本系列为《CMake 工程化进阶》完整 8 篇体系。
本篇目标：真正跑通 CMake 的完整构建流程。

上一节我们讲清了：

• 编译器
• 构建工具
• 构建系统
• CMake 在工程中的位置

这篇开始实战。

我们只做一件事：

用 CMake 构建第一个 C++ 可执行程序。

一、准备一个最小工程

创建目录结构：

MyApp/ main.cpp CMakeLists.txt

main.cpp

#include <iostream> int main() { std::cout << "Hello CMake!" << std::endl; return 0; }

二、写第一个 CMakeLists.txt

cmake_minimum_required(VERSION 3.15) project(MyApp) add_executable(app main.cpp)

只有三行核心内容。

解释一下：

1️⃣ cmake_minimum_required

cmake_minimum_required(VERSION 3.15)

指定最低 CMake 版本。

这是规范写法，必须写。

2️⃣ project()

project(MyApp)

定义工程名称。

它会初始化很多内部变量。

3️⃣ add_executable()

add_executable(app main.cpp)

意思是：

构建一个名为 app 的可执行程序，源文件是 main.cpp。

三、正确的构建方式（非常重要）

不要在源码目录直接运行 cmake。

我们使用：

out-of-source build

也就是源码和构建分离。

第一步：创建 build 目录

mkdir build cd build

第二步：执行配置阶段

cmake ..

含义是：

• 读取上一级目录的 CMakeLists.txt
• 生成构建文件

你会看到：

-- Configuring done
-- Generating done
-- Build files have been written to: ...

第三步：构建

推荐方式：

cmake --build .

或者：

make

第四步：运行

./app

输出：

Hello CMake!

四、CMake 构建的三阶段回顾

现在你已经实际走了一遍：

CMakeLists.txt ↓ cmake .. （Configure + Generate） ↓ cmake --build . ↓ app

这就是完整闭环。

五、Debug / Release 模式（基础理解）

Linux 默认是单配置生成器。

如果你想指定构建类型：

cmake -DCMAKE_BUILD_TYPE=Release ..

常见值：

• Debug
• Release
• RelWithDebInfo

查看当前类型：

cat CMakeCache.txt | grep CMAKE_BUILD_TYPE

六、为什么推荐 cmake --build .？

因为它是跨平台写法。

在 Windows 下：

cmake --build .

会调用：

• MSBuild
• 或 Ninja

而不是 make。

这是推荐习惯。

七、常见错误

1️⃣ 在源码目录运行 cmake

会污染目录。

解决：

删除生成文件，重新使用 build 目录。

2️⃣ 修改 CMakeLists 后不生效

CMake 有缓存机制。

解决：

删除 build 目录重新 cmake。

3️⃣ 找不到 g++

说明系统没有安装编译器。

Linux：

sudo apt install build-essential

Mac：

xcode-select --install

八、你现在掌握了什么？

虽然工程很小，但你已经完成：

• 第一次 CMake 工程
• 理解 build 分离
• 理解 configure / generate / build 三阶段
• 理解 add_executable

这就是 CMake 的最小闭环。

九、下一步

下一篇我们将升级为：

多文件工程 + include 机制

解决最常见的错误：

“找不到头文件”

这才是真正进入工程阶段。

下一篇：

从单文件到多文件工程：CMake 中的 include 机制与目录规范（C++ 工程入门第三课）