CMake 016：深入浅出变量核心用法

✨ 前言：CMake 变量——构建脚本的灵魂骨架 🌐

在 CMake 的宏大世界里，变量如同构建系统的"血液"与"神经"，贯穿于每一个配置、编译、链接的环节之中！✨ 无论是环境路径的配置、第三方库的查找、项目参数的动态定义，还是字符串的智能拼接、日志的彩色输出……都离不开变量的灵活运用与巧妙设计。

掌握 CMake 变量的设置、读取、销毁、嵌套与字符串嵌入等核心技巧，不仅是编写高效、可维护构建脚本的第一步，更是进阶为 CMake 高手的必经之路！🚀 本文将从零开始，系统拆解 CMake 变量的所有核心玩法，并附上逐行解析的实操代码，让你在实战中融会贯通，轻松驾驭 CMake 构建的艺术！

一、CMake 变量基础认知 🌟

在 CMake 的构建脚本体系中，变量扮演着灵魂骨架的角色——它们存储配置信息、传递参数、控制流程，是整个构建过程的核心枢纽！✨ 虽然变量在概念上与常规编程语言中的变量逻辑相通，但 CMake 为其赋予了独特的语法规则、赋值方式和访问形式，形成了专属的变量生态系统。📌

💡核心洞察：CMake 变量不仅仅是简单的值存储，更是构建逻辑的传递者和协调者，它们连接着配置阶段与生成阶段，是 CMake 脚本灵活性的基石。

变量类型全景图 🗺️

在深入细节之前，让我们先俯瞰 CMake 变量的类型全景：

🔍本文聚焦：我们将主要探讨基础自定义变量（普通变量），这是 CMake 脚本中最常用、最核心的变量类型。缓存变量、环境变量等高阶类型将在后续专题中深入探讨。

变量的两大核心能力 🔧

掌握 CMake 变量的关键在于理解其两大核心能力：

1.如何定义 & 赋值变量📝

CMake 变量赋值并不像常规脚本那样直接使用变量名=值的语法，而是依赖专属的内置函数set()来完成。这是 CMake 与普通程序代码最直观、最重要的区别之一！

# ❌ 错误写法（CMake 不支持） MY_VARIABLE = "Hello World" # ✅ 正确写法（使用 set() 函数） set(MY_VARIABLE "Hello World")

2.如何读取 & 访问变量🔍

变量定义后，我们需要在脚本的各个位置访问它的值。CMake 提供了灵活的变量引用机制，让值传递变得自然流畅。

# 定义变量 set(PROJECT_NAME "AwesomeProject") # 访问变量（在 message 中显示） message("项目名称: ${PROJECT_NAME}")

CMake 变量生命周期流程图 🔄

为了更直观地理解 CMake 变量的创建、使用和销毁过程，让我们通过下面的流程图来把握其完整生命周期：

📊图表说明：上图展示了 CMake 变量的完整生命周期。从定义（set()）开始，经过类型判断、作用域确定，到访问使用（${变量名}），最后根据是否需要显式销毁而选择unset()或自动清理。这个流程是理解 CMake

为什么需要这种设计？ 🤔

你可能会问：为什么 CMake 要采用set()函数这种看似“繁琐”的变量赋值方式？原因在于：

1. 作用域清晰：set()函数可以明确指定变量的作用域（PARENT_SCOPE、CACHE等），避免变量污染。
2. 类型安全：支持字符串、列表、布尔等多种类型，且有明确的类型转换规则，减少运行时错误。
3. 缓存机制：为缓存变量提供了统一的接口，便于跨 CMake 运行持久化配置。
4. 向后兼容：保持与早期 CMake 版本的兼容性，确保项目构建的稳定性。

理解了设计背后的考量，能帮助我们更得心应手地使用它。接下来，就让我们正式深入 CMake 变量的核心操作：详细学习set()函数的完整用法、变量访问的多种方式，以及变量在字符串中的嵌入技巧。准备好了吗？让我们继续探索 CMake 变量的奇妙世界！🚀
版本的兼容性

二、变量赋值：set 函数完整用法

2.1 基础单值变量赋值

语法格式：

set(变量名 变量值)

🔍 核心特性：

• set后跟变量名+对应数值，一一映射；

• 重复对同一个变量执行set，会直接覆盖原有值；

• CMake 绝大多数函数语法大小写不敏感，但变量名严格大小写敏感，VAR、Var、var是三个完全独立的变量。

✅ 实操示例代码：

# 定义大写变量 VAR，赋值测试文本 set(VAR "测试变量的值")

2.2 多值自动转为列表

set支持一次性传入多个值，无需额外声明，会自动转为列表类型，后续可遍历取值，本文先聚焦单值场景，列表用法后续拓展。

2.3 变量销毁两种方式

实际开发中，查找第三方库、临时参数配置后，往往需要清空临时变量，CMake 提供两种销毁方式：

1. unset 函数销毁

unset(VAR)

2. set 赋空值等效销毁

set(VAR "")

💡 关键特性：变量被销毁 / 置空后，再次访问不会报错，只会返回空字符串，极大提升了脚本容错性。

三、变量访问：两种读取方式详解

3.1 直接传参引用

在函数传参场景中，可直接书写变量名，无需任何修饰，CMake 会自动识别变量并取值传递。

3.2 标准取值语法${变量名}

这是最常用、通用度最高的访问方式📎，格式为：${变量名称}
原理：脚本执行时，会将${变量名}原地替换为变量存储的原始字符串，属于直接文本替换逻辑。

✅ 变量读取实操代码：

cmake_minimum_required(VERSION 3.10) project(test_VR) # 变量赋值 set(VAR "测试变量的值") # 标准方式访问变量并打印 message("VAR1 = ${VAR}")

📤 输出效果：

VAR1 = 测试变量的值

四、变量嵌入字符串，无缝拼接

CMake 支持直接将变量写入双引号字符串内部，解析时自动完成变量替换，无需额外拼接符号🎯。

✅ 示例代码：

# 变量直接嵌入字符串 message("VAR in string：${VAR}")

📤 输出效果：

VAR in string：测试变量的值

特殊场景：原样输出 $ 符号

如果我们不想让$被解析为变量标识，而是原样打印 $ 和大括号，需要用到转义语法，转义规则和 C++ 保持一致，通过反斜杠 `` 实现字符转义。

✅ 转义实操代码：

# 转义 $ 符号，原样输出语法格式 message("VAR = ${VAR}")

📤 输出效果：

VAR = ${VAR}

五、CMake 变量高阶：嵌套取值

这是 CMake 变量极具特色的能力🌟：变量可以存储另一个变量的名称，实现变量嵌套求值，很多常规编程语言不支持该特性，而 CMake 原生兼容。

嵌套逻辑规则

1. 求值顺序：从内向外逐层解析；

2. 内层变量先解析为字符串，该字符串作为外层变量名，再次取值；

3. 可无限多层嵌套，适配复杂动态配置场景。

✅ 嵌套完整示例代码：

# 定义第一层变量 set(VAR1 "这是原始变量值") # VAR2 存储 VAR1 的变量名 set(VAR2 "VAR1") # 嵌套访问：先取 VAR2 值为 VAR1，再取 VAR1 的真实值 message("VAR2 = ${${VAR2}}")

📤 输出效果：

VAR2 = 这是原始变量值

💡 应用场景：动态配置参数、批量变量遍历、模块化脚本配置，都可以借助变量嵌套简化代码冗余。

六、拓展：变量实现日志彩色输出

在 Linux / Mac 终端、Windows PowerShell 中，可借助ASCII 码 + CMake 变量实现message彩色日志输出🎨。
实现思路：

1. 通过string函数读取十进制 ASCII 颜色编码；

2. 将 ASCII 码存入自定义变量；

3. 日志输出时拼接颜色变量，实现文字变色。

后续可基于本文变量基础，快速搭建一套 CMake 彩色日志工具类，让构建日志层级更清晰、可读性大幅提升。

七、核心知识点总结 🔖

1. 变量赋值依赖set(变量名 值)，重复赋值自动覆盖原值；

2. 变量销毁可用unset(变量名)或set(变量名 "")，空变量访问返回空串不报错；

3. 标准访问语法${变量名}，本质是字符串原地替换；

4. 变量名大小写敏感，函数语法大小写不敏感，需严格区分；

5. 支持字符串内直接嵌入变量，`` 反斜杠实现$符号转义；

6. 支持变量嵌套取值，从内向外逐层解析，适配动态配置场景；

7. 变量是 CMake 脚本核心，后续缓存变量、属性、函数作用域都基于此延伸。

掌握以上 CMake 变量核心用法，就能轻松应对日常项目配置、路径管理、日志输出等开发场景，为后续进阶 CMake 函数、宏、模块编写打下坚实基础。