CMakeLists.txt语法规则：提供信息的变量说明一

server/2024/9/23 9:31:23/

一. 简介

前面几篇文章学习了 CMakeLists.txt语法中部分常用命令。

接下来学习CMakeLists.txt语法中部分常用变量，变量也是 cmake 中的一个重头戏，cmake 提供了很多内置变量。每一个变量都有它自己的含义，可以通过如下链接地址查询到所有的内置变量及其相应的介绍：

https://cmake.org/cmake/help/v3.16/manual/cmake-variables.7.html

在这一份文档中，对变量进行分类。变量分为：提供信息的变量、改变行为的变量、描述系统的变量、控制编译的变量等等。

顾名思义，这种变量可以提供某种信息，既然如此，那么我们通常只需要读取变量即可，而不需要对变量进行修改：

变量	说明
PROJECT_SOURCE_DIR	工程顶层目录，也就是顶层 CMakeLists.txt 源码所在目录
PROJECT_BINARY_DIR	工程 BINARY_DIR ，也就是顶层 CMakeLists.txt 源码的 BINARY_DIR
CMAKE_SOURCE_DIR	与 PROJECT_SOURCE_DIR 等价
CMAKE_BINARY_DIR	与 PROJECT_BINARY_DIR 等价
CMAKE_CURRENT_SOURCE_DIR	当前源码所在路径
CMAKE_CURRENT_BINARY_DIR	当前源码的 BINARY_DIR
CMAKE_MAJOR_VERSION	cmake 的主版本号
CMAKE_MINOR_VERSION	cmake 的次版本号
CMAKE_VERSION	cmake 的版本号（主+次+修订）
PROJECT_VERSION_MAJOR	工程的主版本号
PROJECT_VERSION_MINOR	工程的次版本号
PROJECT_VERSION	工程的版本号
CMAKE_PROJECT_NAME	工程的名字
PROJECT_NAME	工程名，与 CMAKE_PROJECT_NAME 等价

PROJECT_SOURCE_DIR 变量表示工程的顶级目录，也就是顶层 CMakeLists.txt 文件所在目录；

PROJECT_BINARY_DIR 变量表示工程的 BINARY_DIR ，也就是顶层 CMakeLists.txt 源码对应的 BINARY_DIR （输出文件目录）。

譬如工程目录结构如下所示：

CMakeLists.txt 文件内容如下：

# CMakeLists.txt
cmake_minimum_required("VERSION" "3.16")
project(HELLO)
message(${PROJECT_SOURCE_DIR})
message(${PROJECT_BINARY_DIR})

CMakeLists.txt 中，我们打印了 PROJECT_SOURCE_DIR 和 PROJECT_BINARY_DIR 变量，进入到 build 目录下，执行 cmake ：

从打印信息可知， PROJECT_SOURCE_DIR 指的就是工程的顶层 CMakeLists.txt 源码所在路径，而 PROJECT_BINARY_DIR 指的是我们执行 cmake 命令的所在目录。

与上面两个等价，大家自己打印出来看看便知！

向顶层 CMakeLists.txt 添加打印命令：

message(${CMAKE_SOURCE_DIR})
message(${CMAKE_BINARY_DIR})

进入 build目录下，执行 cmake ..命令后如下：

可以看出，与 PROJECT_SOURCE_DIR，PROJECT_BINARY_DIR一样的目录。