第6章 CMake变量与缓存

课程目录第6章 CMake变量与缓存

CMake变量与缓存：从入门到精通

各位同学好，今天我们来聊聊CMake里最基础也最核心的概念——变量与缓存。说实话，我刚开始接触CMake时，觉得变量不就是个存值的东西嘛，有啥好讲的？结果在实际项目中踩了不少坑，才明白这里面的门道有多深。

你想想看，一个大型Android NDK项目，可能有几十个模块，上百个配置项。如果没有一套清晰的变量管理机制，那代码维护起来简直是一场噩梦。今天我就把我在实战中积累的经验，毫无保留地分享给大家。

1. set()命令：变量的基本操作

set()是CMake里最常用的命令，没有之一。它的基本语法很简单：

set(变量名 值 [CACHE 类型 描述 [FORCE]])

举个例子：

set(MY_NAME "Android开发")
set(MY_VERSION 1.0)
set(MY_FEATURES feature1 feature2 feature3)

这里有个细节我想强调一下——CMake里所有变量本质上都是字符串。你写set(MY_VERSION 1.0)，它存的其实是字符串"1.0"。但CMake会在需要时自动做类型转换，所以大多数情况下你不需要操心这个。

💡 个人小技巧： 我习惯在命名变量时全部用大写字母，单词间用下划线分隔。这样一眼就能看出哪些是变量，哪些是命令或目标。比如ANDROID_ABI、CMAKE_CXX_FLAGS。

2. 变量作用域：函数、目录与全局

变量作用域这个问题，我当年可是吃了不少苦头。简单来说，CMake有三种作用域：

函数作用域：在function()内部定义的变量，外部不可见
目录作用域：每个CMakeLists.txt文件有自己的作用域
全局作用域：使用set(PARENT_SCOPE)或缓存变量可以跨作用域

看个例子你就明白了：

set(GLOBAL_VAR "我是全局的")

function(my_func)
    set(LOCAL_VAR "我是局部的")
    message("内部: ${LOCAL_VAR}")  # 输出：我是局部的
    message("内部: ${GLOBAL_VAR}") # 输出：我是全局的
endfunction()

my_func()
message("外部: ${LOCAL_VAR}")  # 输出：空（访问不到）

为什么会这样？因为函数内部默认会创建自己的变量副本。如果你想修改外部的变量，得用PARENT_SCOPE：

function(set_parent)
    set(MY_VAR "新值" PARENT_SCOPE)
endfunction()

⚠️ 避坑指南： 我曾经在一个大型项目中，因为没注意作用域问题，导致两个子目录的CMakeLists.txt里定义了同名变量，结果相互覆盖，编译出来一堆莫名其妙的错误。排查了整整一个下午才找到原因。所以，跨目录的变量一定要用缓存变量或者显式传递。

3. 缓存变量：跨构建持久化

缓存变量是CMake里一个非常强大的特性。普通变量只在当前CMake运行期间有效，但缓存变量会保存在CMakeCache.txt文件中，下次运行CMake时仍然存在。

定义缓存变量的方式：

set(MY_CACHE_VAR "默认值" CACHE STRING "这是一个缓存变量")

这里STRING是变量类型，CMake支持以下几种：

类型	说明	典型用途
BOOL	布尔值	开关选项，如`BUILD_SHARED_LIBS`
STRING	字符串	路径、名称等
FILEPATH	文件路径	指定某个文件的路径
PATH	目录路径	指定某个目录的路径
INTERNAL	内部变量	不显示在CMake GUI中

缓存变量有个特点：如果变量已经存在，set()不会覆盖它。除非你加上FORCE：

set(MY_CACHE_VAR "强制覆盖" CACHE STRING "描述" FORCE)

  🔑 核心要点： 在Android NDK开发中，我们经常用缓存变量来保存用户的选择，比如ANDROID_ABI、ANDROID_PLATFORM等。这样用户只需要在第一次配置时设置一次，后续重新运行CMake时这些值会自动保留。

4. CMake预设变量：拿来即用

CMake内置了很多预设变量，这些变量在配置阶段就已经被赋值好了。我挑几个在NDK开发中最常用的：

CMAKE_SOURCE_DIR：顶层CMakeLists.txt所在的目录
CMAKE_BINARY_DIR：构建目录
CMAKE_CURRENT_SOURCE_DIR：当前处理的CMakeLists.txt所在目录
CMAKE_CURRENT_BINARY_DIR：当前处理目录对应的构建目录
PROJECT_NAME：通过project()命令设置的项目名称
PROJECT_SOURCE_DIR：当前项目的源码目录
ANDROID_ABI：Android目标ABI（如armeabi-v7a、arm64-v8a）
ANDROID_PLATFORM：Android平台版本（如android-21）

举个例子，在NDK项目中我们经常这样用：

# 根据不同的ABI设置不同的编译选项
if(ANDROID_ABI STREQUAL "arm64-v8a")
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -march=armv8-a")
elseif(ANDROID_ABI STREQUAL "armeabi-v7a")
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -march=armv7-a -mfpu=neon")
endif()

# 输出构建信息
message(STATUS "构建目录: ${CMAKE_BINARY_DIR}")
message(STATUS "目标ABI: ${ANDROID_ABI}")

💡 调试小技巧： 当你搞不清楚某个预设变量的值时，直接用message()打印出来看看。我经常在CMakeLists.txt里写message(STATUS "DEBUG: CMAKE_SOURCE_DIR = ${CMAKE_SOURCE_DIR}")来确认路径是否正确。

5. 变量引用与展开：${}的奥秘

在CMake中，使用${变量名}来引用变量。这个过程叫做"变量展开"。但这里有个容易混淆的地方——变量展开是在解析阶段完成的，而不是在运行时。

看个例子：

set(FOO "Hello")
set(BAR "FOO")
message("${${BAR}}")  # 输出：Hello

这个${${BAR}}是什么意思呢？首先展开${BAR}得到"FOO"，然后再展开${FOO}得到"Hello"。这种嵌套引用在某些高级场景下非常有用，但日常开发中我建议少用，容易把人绕晕。

还有一个常见的坑是转义问题。如果你真的想输出${}这个字符串，需要用反斜杠转义：

message("\${变量名}")  # 输出：${变量名}

⚠️ 避坑指南： 我曾经在写一个复杂的宏时，忘记了对$符号进行转义，结果CMake把我想输出的文本当成了变量引用，展开后变成了空字符串。排查了半天才发现是这个问题。所以，只要你想输出$符号，一定要记得加反斜杠。

6. NDK实战：综合运用

好了，理论讲完了，我们来个实战例子。假设我们要写一个CMakeLists.txt，用于构建一个支持多ABI的Android Native库：

cmake_minimum_required(VERSION 3.10)
project(MyNativeLib)

# 设置C++标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 根据ABI设置不同的优化选项
if(ANDROID_ABI STREQUAL "arm64-v8a")
    set(OPT_FLAGS "-O3 -march=armv8-a+crypto")
elseif(ANDROID_ABI STREQUAL "armeabi-v7a")
    set(OPT_FLAGS "-O2 -march=armv7-a -mfpu=neon")
else()
    set(OPT_FLAGS "-O2")
endif()

# 将优化选项添加到编译标志中
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${OPT_FLAGS}")

# 添加库
add_library(mylib SHARED
    src/core.cpp
    src/utils.cpp
    src/jni_bridge.cpp
)

# 链接依赖库
target_link_libraries(mylib
    log
    android
)

# 输出构建信息
message(STATUS "========================================")
message(STATUS "项目名称: ${PROJECT_NAME}")
message(STATUS "源码目录: ${PROJECT_SOURCE_DIR}")
message(STATUS "构建目录: ${CMAKE_BINARY_DIR}")
message(STATUS "目标ABI: ${ANDROID_ABI}")
message(STATUS "优化选项: ${OPT_FLAGS}")
message(STATUS "========================================")

这个例子综合运用了我们今天讲的所有知识点：

用set()定义变量
用${}引用变量
用预设变量获取项目信息
用条件判断处理不同ABI

嗯，到这里，CMake变量与缓存的核心内容就讲完了。这些东西看似基础，但真要在项目中用好，还是需要一些实践积累的。我个人建议，刚开始学的时候，多写几个message()打印变量值，看看它们到底存了什么，这样理解会更深刻。

记住一句话：变量是CMake的血液，缓存是CMake的记忆。把这两样东西搞明白了，你的CMake功力至少提升一半。

📚 课程目录

CMake变量与缓存：从入门到精通

1. set()命令：变量的基本操作

2. 变量作用域：函数、目录与全局

3. 缓存变量：跨构建持久化

4. CMake预设变量：拿来即用

5. 变量引用与展开：${}的奥秘

6. NDK实战：综合运用