CMake 是一个跨平台的构建工具生成器，它本身不直接编译代码，而是根据 CMakeLists.txt 配置文件生

成对应平台（如 Linux 下的 Makefile、Windows 下的 Visual Studio 工程文件等）的构建脚本。掌握其

基本语法规则是进行 C/C++ 项目标准化构建的基础。

以下是 CMake 入门的核心语法规则与最佳实践：

一、核心认知与工作流程

1. 核心概念

非编译器‌：CMake 不编译代码，它生成构建系统文件。

跨平台‌：一次编写 CMakeLists.txt，可在 Linux、macOS、Windows 等不同平台生成对应的构建文件。

配置文件‌：所有规则必须写在名为 CMakeLists.txt的文件中（大小写敏感）。

2. 标准构建流程（Out-of-Source Build）

推荐将源码与编译产物分离，保持源码目录整洁。

创建构建目录‌：mkdir build && cd build

生成构建文件‌：cmake .. （解析上级目录的 CMakeLists.txt）

执行编译‌：make （Linux/Mac）或打开生成的 .sln 文件（Windows）

运行程序‌：./executable_name

二、基础语法规范

大小写不敏感‌：指令 cmake_minimum_required 与 CMAKE_MINIMUM_REQUIRED 等效，但推荐统

一使用‌小写指令‌和‌大写变量‌以符合社区规范。

指令格式‌：指令(参数1 参数2 ...)，参数间用空格或分号分隔。

注释‌：使用 # 进行单行注释，CMake 原生不支持多行注释。

变量引用‌：使用 ${变量名} 引用变量值。

三、必备核心指令详解

在一个标准的 C 语言项目中，以下指令是高频且必须的：

1. 版本与项目定义

cmake

# 指定CMake最低版本，防止语法不兼容

cmake_minimum_required(VERSION 3.10)

# 定义项目名称，CMake会自动初始化相关变量

project(MyProject C)

2. 设置编译标准

对于 C 语言项目，明确指定标准至关重要，以启用现代特性（如 C99/C11）。

cmake

# 设置C语言标准为C99

set(CMAKE_C_STANDARD 99)

# 要求编译器必须支持该标准，否则报错

set(CMAKE_C_STANDARD_REQUIRED ON)

3. 生成可执行文件

这是最核心的指令，将源文件编译链接为可执行程序。

cmake

# 语法: add_executable(目标名称 源文件列表)

add_executable(main main.c)

4. 批量管理源文件

当源文件较多时，避免手动罗列，可使用辅助命令收集文件。

cmake

# 将 src 目录下所有 .c 文件路径存入 SRC_LIST 变量

file(GLOB SRC_LIST "src/*.c")

add_executable(app ${SRC_LIST})

注意：file(GLOB) 在新增文件时可能需要重新运行 CMake，大型项目更推荐使用 target_sources 或手动维护列表以确保依赖追踪准确。

5. 头文件搜索路径

当头文件不在当前目录时，需告知编译器去哪里查找。

cmake

# 添加头文件搜索目录，等效于 gcc 的 -I 参数

include_directories(include)

最佳实践：推荐使用 target_include_directories 针对特定目标设置，作用域更清晰。

6. 库文件的编译与链接

模块化开发中，常将公共代码编译为库。

编译库：‌

cmake

# 编译静态库 STATIC 或动态库 SHARED

add_library(mylib STATIC lib_src.c)

链接库：‌

cmake

# 将 mylib 链接到 main 可执行文件

target_link_libraries(main mylib)

四、最小化实战示例

假设项目结构如下：

text

MyProject/

├── CMakeLists.txt

└── main.c

main.c:‌

c

#include <stdio.h>

int main() {

    printf("Hello, CMake!\n");

    return 0;

}

CMakeLists.txt:‌

cmake

cmake_minimum_required(VERSION 3.10)

project(HelloCMake C)

set(CMAKE_C_STANDARD 99)

set(CMAKE_C_STANDARD_REQUIRED ON)

add_executable(hello main.c)

构建命令：‌

bash

mkdir build

cd build

cmake ..

make

./hello

五、最佳实践建议

外部构建‌：始终使用 build 目录进行外部构建，避免污染源码目录。

目标属性优先‌：尽量使用 target_ 开头的命令（如 target_include_directories, target_link_libraries），它们比全局命令（如 include_directories）具有更好的作用域控制和现代 CMake 特性支持。

版本控制‌：在 cmake_minimum_required 中指定一个较新的稳定版本（如 3.10+），以利用更完善的特性。

避免硬编码‌：尽量使用变量和相对路径，确保项目在不同机器上的可移植性。