✨ 前言：CMake 变量------构建脚本的灵魂骨架 🌐
在 CMake 的宏大世界里，变量如同构建系统的"血液"与"神经"，贯穿于每一个配置、编译、链接的环节之中！✨ 无论是环境路径的配置、第三方库的查找、项目参数的动态定义，还是字符串的智能拼接、日志的彩色输出......都离不开变量的灵活运用与巧妙设计。
掌握 CMake 变量的设置、读取、销毁、嵌套与字符串嵌入 等核心技巧，不仅是编写高效、可维护构建脚本的第一步 ，更是进阶为 CMake 高手的必经之路 ！🚀 本文将从零开始，系统拆解 CMake 变量的所有核心玩法，并附上逐行解析的实操代码，让你在实战中融会贯通，轻松驾驭 CMake 构建的艺术！
一、CMake 变量基础认知 🌟
在 CMake 的构建脚本体系中，变量扮演着灵魂骨架 的角色------它们存储配置信息、传递参数、控制流程，是整个构建过程的核心枢纽 ！✨ 虽然变量在概念上与常规编程语言中的变量逻辑相通，但 CMake 为其赋予了独特的语法规则、赋值方式和访问形式，形成了专属的变量生态系统。📌
💡 核心洞察 ：CMake 变量不仅仅是简单的值存储，更是构建逻辑的传递者 和协调者，它们连接着配置阶段与生成阶段，是 CMake 脚本灵活性的基石。
变量类型全景图 🗺️
在深入细节之前，让我们先俯瞰 CMake 变量的类型全景：
| 变量类型 | 作用域 | 生命周期 | 典型用途 |
|---|---|---|---|
| 普通变量 | 当前目录及子目录 | 当前 CMakeLists.txt 执行期间 | 临时存储、逻辑控制 |
| 缓存变量 | 全局可见 | 跨 CMake 运行持久化 | 用户配置选项、平台参数 |
| 环境变量 | 系统环境 | 进程生命周期 | 系统路径、编译器设置 |
| 内置变量 | 全局 | CMake 运行时 | 系统信息、编译器特性 |
🔍 本文聚焦 ：我们将主要探讨基础自定义变量（普通变量），这是 CMake 脚本中最常用、最核心的变量类型。缓存变量、环境变量等高阶类型将在后续专题中深入探讨。
变量的两大核心能力 🔧
掌握 CMake 变量的关键在于理解其两大核心能力：
1. 如何定义 & 赋值变量 📝
CMake 变量赋值并不像 常规脚本那样直接使用 变量名=值 的语法，而是依赖专属的内置函数 set() 来完成。这是 CMake 与普通程序代码最直观、最重要的区别之一！
cmake
# ❌ 错误写法（CMake 不支持）
MY_VARIABLE = "Hello World"
# ✅ 正确写法（使用 set() 函数）
set(MY_VARIABLE "Hello World")2. 如何读取 & 访问变量 🔍
变量定义后，我们需要在脚本的各个位置访问它的值。CMake 提供了灵活的变量引用机制，让值传递变得自然流畅。
cmake
# 定义变量
set(PROJECT_NAME "AwesomeProject")
# 访问变量（在 message 中显示）
message("项目名称: ${PROJECT_NAME}")CMake 变量生命周期流程图 🔄
为了更直观地理解 CMake 变量的创建、使用和销毁过程，让我们通过下面的流程图来把握其完整生命周期：
📊 图表说明 ：上图展示了 CMake 变量的完整生命周期。从定义（
set()）开始，经过类型判断、作用域确定，到访问使用（${变量名}），最后根据是否需要显式销毁而选择unset()或自动清理。这个流程是理解 CMake
为什么需要这种设计？ 🤔
你可能会问：为什么 CMake 要采用 set() 函数这种看似"繁琐"的变量赋值方式？原因在于：
- 作用域清晰 ：
set()函数可以明确指定变量的作用域（PARENT_SCOPE、CACHE等），避免变量污染。 - 类型安全：支持字符串、列表、布尔等多种类型，且有明确的类型转换规则，减少运行时错误。
- 缓存机制：为缓存变量提供了统一的接口，便于跨 CMake 运行持久化配置。
- 向后兼容：保持与早期 CMake 版本的兼容性，确保项目构建的稳定性。
理解了设计背后的考量，能帮助我们更得心应手地使用它。接下来，就让我们正式深入 CMake 变量的核心操作：详细学习 set() 函数的完整用法、变量访问的多种方式，以及变量在字符串中的嵌入技巧。准备好了吗？让我们继续探索 CMake 变量的奇妙世界！🚀 版本的兼容性
二、变量赋值：set 函数完整用法
2.1 基础单值变量赋值
语法格式：
cmake
set(变量名 变量值)🔍 核心特性：
-
set后跟变量名 + 对应数值，一一映射； -
重复对同一个变量执行
set，会直接覆盖原有值； -
CMake 绝大多数函数语法大小写不敏感，但变量名严格大小写敏感 ，
VAR、Var、var是三个完全独立的变量。
✅ 实操示例代码：
cmake
# 定义大写变量 VAR，赋值测试文本
set(VAR "测试变量的值")2.2 多值自动转为列表
set 支持一次性传入多个值，无需额外声明，会自动转为列表类型，后续可遍历取值，本文先聚焦单值场景，列表用法后续拓展。
2.3 变量销毁两种方式
实际开发中，查找第三方库、临时参数配置后，往往需要清空临时变量，CMake 提供两种销毁方式：
- unset 函数销毁
cmake
unset(VAR)- set 赋空值等效销毁
cmake
set(VAR "")💡 关键特性：变量被销毁 / 置空后，再次访问不会报错，只会返回空字符串，极大提升了脚本容错性。
三、变量访问：两种读取方式详解
3.1 直接传参引用
在函数传参场景中，可直接书写变量名，无需任何修饰，CMake 会自动识别变量并取值传递。
3.2 标准取值语法 ${变量名}
这是最常用、通用度最高的访问方式📎，格式为：${变量名称} 原理：脚本执行时，会将 ${变量名} 原地替换为变量存储的原始字符串，属于直接文本替换逻辑。
✅ 变量读取实操代码：
cmake
cmake_minimum_required(VERSION 3.10)
project(test_VR)
# 变量赋值
set(VAR "测试变量的值")
# 标准方式访问变量并打印
message("VAR1 = ${VAR}")📤 输出效果：
Plain
VAR1 = 测试变量的值四、变量嵌入字符串，无缝拼接
CMake 支持直接将变量写入双引号字符串内部，解析时自动完成变量替换，无需额外拼接符号🎯。
✅ 示例代码：
cmake
# 变量直接嵌入字符串
message("VAR in string：${VAR}")📤 输出效果：
Plain
VAR in string：测试变量的值特殊场景：原样输出 $ 符号
如果我们不想让 $ 被解析为变量标识，而是原样打印 $ 和大括号 ，需要用到转义语法，转义规则和 C++ 保持一致，通过反斜杠 `` 实现字符转义。
✅ 转义实操代码：
cmake
# 转义 $ 符号，原样输出语法格式
message("VAR = ${VAR}")📤 输出效果：
Plain
VAR = ${VAR}五、CMake 变量高阶：嵌套取值
这是 CMake 变量极具特色的能力🌟：变量可以存储另一个变量的名称，实现变量嵌套求值，很多常规编程语言不支持该特性，而 CMake 原生兼容。
嵌套逻辑规则
-
求值顺序：从内向外逐层解析；
-
内层变量先解析为字符串，该字符串作为外层变量名，再次取值；
-
可无限多层嵌套，适配复杂动态配置场景。
✅ 嵌套完整示例代码：
cmake
# 定义第一层变量
set(VAR1 "这是原始变量值")
# VAR2 存储 VAR1 的变量名
set(VAR2 "VAR1")
# 嵌套访问：先取 VAR2 值为 VAR1，再取 VAR1 的真实值
message("VAR2 = ${${VAR2}}")📤 输出效果：
Plain
VAR2 = 这是原始变量值💡 应用场景：动态配置参数、批量变量遍历、模块化脚本配置，都可以借助变量嵌套简化代码冗余。
六、拓展：变量实现日志彩色输出
在 Linux / Mac 终端、Windows PowerShell 中，可借助 ASCII 码 + CMake 变量 实现 message 彩色日志输出🎨。 实现思路：
-
通过
string函数读取十进制 ASCII 颜色编码； -
将 ASCII 码存入自定义变量；
-
日志输出时拼接颜色变量，实现文字变色。
后续可基于本文变量基础，快速搭建一套 CMake 彩色日志工具类，让构建日志层级更清晰、可读性大幅提升。
七、核心知识点总结 🔖
-
变量赋值依赖
set(变量名 值)，重复赋值自动覆盖原值； -
变量销毁可用
unset(变量名)或set(变量名 "")，空变量访问返回空串不报错； -
标准访问语法
${变量名}，本质是字符串原地替换； -
变量名大小写敏感，函数语法大小写不敏感，需严格区分；
-
支持字符串内直接嵌入变量，`` 反斜杠实现
$符号转义； -
支持变量嵌套取值，从内向外逐层解析，适配动态配置场景；
-
变量是 CMake 脚本核心，后续缓存变量、属性、函数作用域都基于此延伸。
掌握以上 CMake 变量核心用法，就能轻松应对日常项目配置、路径管理、日志输出等开发场景，为后续进阶 CMake 函数、宏、模块编写打下坚实基础。