C / C++ / 系统课时

写出最小 CMakeLists.txt

写出最小 CMakeLists.txt

一个最小 CMake 项目只需要声明最低版本、项目名称与语言,再定义要生成的目标。本节用一个可运行的 C 程序写出最小 CMakeLists.txt,完成配置、构建和运行,并说明三个核心命令各自承担什么职责。

学习目标

  • 会使用 cmake_minimum_required、project 和 add_executable
  • 能把一个 C 源文件配置并构建成可执行程序
  • 能通过运行结果验证 CMakeLists.txt 是否生效

三条命令就能描述最小项目

在项目根目录创建 CMakeLists.txt。下面的配置声明 CMake 版本下限,将项目命名为 hello,并告诉 CMake 用 main.c 生成名为 hello 的可执行目标。

cmake
cmake_minimum_required(VERSION 3.16)

project(hello C)

add_executable(hello main.c)

这是配置文件,不会直接产生控制台输出。保存后可用 cmake -S . -B build 验证语法与生成行为:若配置成功,CMake 会在 build 目录写入底层构建文件,而不会污染源码目录。

三个命令的职责不同:cmake_minimum_required 约束可接受的最低 CMake 版本并确定相应策略;project 建立项目并启用 C 语言;add_executable 创建一个构建目标,并把 main.c 作为该目标的源文件。

准备可以编译的 C 源码

在同一目录创建 main.c。示例只有一个入口函数,便于把注意力集中在构建描述本身。

c
#include <stdio.h>

int main(void) {
    puts("hello from cmake");
    return 0;
}

这段源码由后续构建阶段调用系统中的 C 编译器处理。CMake 不负责实现 C 语言编译,它负责把目标信息转换成底层构建系统可以执行的规则。

配置、构建并运行

在 Linux 或 macOS 终端进入项目根目录后执行以下命令。-S . 指定源码目录为当前目录,-B build 指定独立构建目录;之后使用统一的 cmake --build 入口触发实际编译。

bash
cmake -S . -B build
cmake --build build
./build/hello

预期输出的前两步会包含编译器检测、配置和构建进度,具体行数与路径因环境而异;程序运行结果应为下面这一行。

text
hello from cmake

如果使用 Visual Studio、Xcode 等多配置生成器,可执行文件可能位于 build/Debug 或其他配置目录。此时应按生成器的产物位置运行,而不是把路径问题误判为编译失败。

修改配置后怎样验证

把目标名改成 greeting 时,应同时理解产物名也会变化。修改 CMakeLists.txt 后重新执行配置和构建即可,通常不需要手工删除整个 build 目录。

cmake
cmake_minimum_required(VERSION 3.16)

project(hello C)

add_executable(greeting main.c)

配置生效行为是:底层构建规则中的目标从 hello 更新为 greeting。验证时再次执行 cmake -S . -B build 和 cmake --build build,再运行对应的新产物。

掌握这三条命令后,已经能够让 CMake 接管最小 C 工程。后续增加多个源文件、库和测试时,本质上仍是在同一个目标模型上继续补充关系,而不是回到手写完整编译命令。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

写出最小 CMakeLists.txt

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通