4、变量与缓存：CMake变量定义与引用，set命令，缓存变量，环境变量

各位同学，咱们今天聊聊CMake里的变量。说实话，变量这东西，看着简单，但坑不少。我刚开始用CMake那会儿，就因为在变量作用域上栽过跟头，折腾了一下午才找到原因。今天我把这些经验都抖出来，你们少走点弯路。

4.1 变量的定义与引用

CMake里定义变量，最常用的就是 set() 命令。语法很简单：

set(变量名 值)

引用变量时，用 ${变量名} 包起来。举个例子：

set(MY_NAME "Hello CMake")
message("我的变量值是：${MY_NAME}")

这里要注意，message() 是CMake的打印命令，相当于C语言的 printf。我习惯用它来调试变量值，特别管用。

小技巧： 如果变量名里包含特殊字符，或者你想拼接字符串，可以用 ${} 嵌套。比如 set(FOO "${BAR}_suffix")，这在处理路径时很常见。

4.2 set命令的多种用法

set() 命令其实挺灵活的，不只是赋值那么简单。咱们看看它还能干啥：

用法 示例 说明
普通变量 set(VAR "value") 最基础的定义方式
列表变量 set(LIST_VAR a b c) 多个值用空格或分号分隔
缓存变量 set(VAR "val" CACHE STRING "描述") 会写入CMakeCache.txt
环境变量 set(ENV{VAR} "value") 操作系统的环境变量

列表变量这块，我多说两句。你想想看，如果你要定义一个源文件列表：

set(SOURCES
    src/main.c
    src/utils.c
    src/io.c
)

这样写，每个文件占一行，清晰明了。我在实际项目中，经常用这种方式组织源文件，比写在一行里好维护多了。

4.3 缓存变量——CMake的"记忆"

缓存变量是CMake里一个很重要的概念。说白了，它就是能记住你上次设置的值。为什么需要这个？

假设你有一个交叉编译工具链路径，每次运行CMake都要重新指定，那多烦人。缓存变量就是来解决这个问题的。

set(TOOLCHAIN_PATH "/usr/local/arm-gcc" CACHE PATH "交叉编译工具链路径")

加上 CACHE 关键字后，这个变量会被写入 CMakeCache.txt 文件。下次再运行CMake，它会自动读取这个值。

注意： 缓存变量一旦设置，就不会被普通 set() 覆盖。如果你想强制更新，需要加 FORCE 关键字：set(VAR "new" CACHE STRING "" FORCE)。我曾经因为这个特性，调试了半天才发现是缓存没更新。

缓存变量的类型也很重要，常用的有：

  • STRING — 字符串，最常用
  • BOOL — 布尔值，ON/OFF
  • PATH — 路径，会自动补全
  • FILEPATH — 文件路径
  • INTERNAL — 内部变量，不显示在cmake-gui中

4.4 环境变量——与系统打交道

环境变量是CMake和操作系统之间的桥梁。比如你想获取系统的 PATH 环境变量：

message("系统PATH：$ENV{PATH}")

设置环境变量也很简单：

set(ENV{MY_VAR} "hello from cmake")

不过要注意，这个设置只对当前CMake进程有效，不会影响父进程的环境变量。嗯，这里要提醒一下，别指望用CMake永久修改系统环境变量。

我在做交叉编译时，经常需要设置 CC 和 CXX 环境变量来指定编译器：

set(ENV{CC} "/usr/local/arm-gcc/bin/arm-linux-gcc")
set(ENV{CXX} "/usr/local/arm-gcc/bin/arm-linux-g++")

4.5 变量作用域——别踩这个坑

CMake的变量作用域，说白了就是：子目录和函数里定义的变量，外面看不到。除非你用 PARENT_SCOPE 关键字。

# 在子目录或函数中
set(MY_VAR "hello" PARENT_SCOPE)

我刚开始学CMake时，就遇到过这个问题。在一个子目录里定义了个变量，回到主目录怎么都访问不到。后来才发现，原来变量默认只在当前作用域有效。

核心要点：
  • 普通变量：只在当前CMakeLists.txt和其子作用域可见
  • 缓存变量：全局可见，所有CMakeLists.txt都能访问
  • 环境变量：全局可见，但只影响当前进程

4.6 实战：一个完整的变量使用示例

咱们来写一个实际的例子，把今天学的都用上：

# 设置项目信息
set(PROJECT_NAME "MyApp")
set(PROJECT_VERSION "1.0.0")

# 设置编译选项（缓存变量，用户可修改）
set(ENABLE_DEBUG ON CACHE BOOL "启用调试模式")

# 设置源文件列表
set(SOURCES
    main.c
    utils.c
    network.c
)

# 获取系统架构
message("当前系统：$ENV{OS}")
message("处理器架构：$ENV{PROCESSOR_ARCHITECTURE}")

# 根据条件设置不同值
if(ENABLE_DEBUG)
    set(COMPILE_FLAGS "-g -O0")
else()
    set(COMPILE_FLAGS "-O2")
endif()

message("编译标志：${COMPILE_FLAGS}")

这个例子涵盖了普通变量、缓存变量、环境变量，还有条件判断。你想想看，在实际项目中，这种模式非常常见。特别是那个 ENABLE_DEBUG 缓存变量，用户可以在命令行用 -DENABLE_DEBUG=OFF 来关闭调试模式，很方便。

好了，关于CMake的变量与缓存，今天就聊到这儿。记住一句话：普通变量是临时的，缓存变量是持久的，环境变量是系统的。搞清楚了这三者的区别，你在CMake里处理变量就不会再迷路了。

← 上一章 📖 返回目录 下一章 →