第4章变量与类型

课程目录第4章变量与类型

第1章：变量与类型——CMake构建系统的基石

说实话，我刚接触CMake那会儿，觉得变量这东西有啥好讲的？不就是存个字符串嘛。直到我在一个大型嵌入式项目里，因为变量作用域搞混，整整浪费了两天时间排查问题……嗯，从那以后，我再也不敢小看CMake的变量系统了。

今天咱们就来聊聊CMake里的四种变量类型：字符串、列表、缓存和环境变量。我会结合自己的踩坑经历，帮你把这些概念彻底搞清楚。

1.1 字符串变量：最基础的存在

CMake里一切变量本质上都是字符串。你定义一个变量，它存的就是一串字符。

set(MY_VAR "Hello, CMake!")
message(STATUS "MY_VAR = ${MY_VAR}")

这里有个细节我特别想强调：引号不是必须的，但建议你养成加引号的好习惯。为什么？

set(BAD_VAR Hello World)  # 这其实是两个参数！
set(GOOD_VAR "Hello World")  # 这才是一个字符串

⚠️ 我曾经踩过的坑： 不加引号时，如果字符串里包含空格，CMake会把它当成多个参数。结果就是变量只存了第一个词，后面的全丢了。排查这种bug特别痛苦，因为message打印出来看着好像没问题……

1.2 列表变量：用分号分隔的字符串

列表变量说白了就是特殊格式的字符串——用分号分隔元素。我个人习惯把列表想象成数组，但底层其实还是字符串。

set(SOURCES main.cpp utils.cpp network.cpp)
# 等价于 set(SOURCES "main.cpp;utils.cpp;network.cpp")

message(STATUS "SOURCES = ${SOURCES}")
# 输出: SOURCES = main.cpp;utils.cpp;network.cpp

列表操作有几个常用命令，我几乎每个项目都会用到：

# 获取列表长度
list(LENGTH SOURCES len)
message("源文件数量: ${len}")

# 获取第一个元素
list(GET SOURCES 0 first_file)
message("第一个文件: ${first_file}")

# 追加元素
list(APPEND SOURCES "new_file.cpp")

# 排序
list(SORT SOURCES)

💡 我的经验： 在大型项目中，我习惯把所有源文件先收集到一个列表里，最后统一传给add_executable或add_library。这样管理起来特别清晰，也方便做条件编译。

1.3 缓存变量：跨文件共享的秘密

缓存变量是CMake里最容易让人迷惑的概念之一。你想想看，CMake运行时会生成CMakeCache.txt文件，缓存变量就存在这里面。

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

缓存变量有几个特点：

持久化：一次设置，下次cmake运行时仍然有效
可覆盖：用户可以通过-D选项在命令行修改
类型声明：需要指定类型（STRING、BOOL、PATH等）

🔑 关键区别： 普通变量只在当前CMakeLists.txt及其子目录有效。缓存变量则全局可见，而且会写入CMakeCache.txt。

我记得有一次，同事在子目录里set了一个变量，主目录怎么都访问不到。折腾半天才发现，他应该用缓存变量或者用set的PARENT_SCOPE选项。

# 子目录中设置，让父目录也能访问
set(SHARED_VAR "共享数据" CACHE INTERNAL "内部缓存变量")

1.4 环境变量：与操作系统打交道

环境变量是CMake和操作系统之间的桥梁。用$ENV{}读取，用set(ENV{})设置。

# 读取系统环境变量
message("PATH = $ENV{PATH}")
message("HOME = $ENV{HOME}")

# 设置环境变量（仅影响当前CMake进程）
set(ENV{MY_ENV_VAR} "临时值")

⚠️ 注意： CMake里设置的环境变量只在当前进程有效，不会影响父shell。我刚开始学的时候以为能永久修改系统环境变量，结果发现每次重新打开终端就没了。

环境变量在交叉编译时特别有用。比如指定工具链路径：

# 假设环境变量 TOOLCHAIN_PATH 已经设置
set(CMAKE_C_COMPILER "$ENV{TOOLCHAIN_PATH}/bin/gcc")
set(CMAKE_CXX_COMPILER "$ENV{TOOLCHAIN_PATH}/bin/g++")

1.5 变量的作用域：层级与隔离

作用域是CMake变量系统里最核心的概念，也是bug最多的地方。说白了，每个add_subdirectory调用都会创建一个新的作用域。

咱们用一张图来理解：

从这张图能看出几个关键点：

子目录可以访问父目录的变量，但反过来不行
兄弟目录之间互相隔离，A看不到B的变量
缓存变量是全局的，谁都能读写

🔑 作用域穿透技巧： 如果你非要在子目录里修改父目录的变量，可以用 set(VAR value PARENT_SCOPE)。但说实话，我建议少用这个特性，它会让代码逻辑变得很难追踪。

1.6 实战：一个完整的例子

咱们把今天学的知识串起来，写一个实际点的CMakeLists.txt：

cmake_minimum_required(VERSION 3.16)
project(VariableDemo VERSION 1.0.0)

# 字符串变量
set(PROJECT_DESCRIPTION "一个CMake变量演示项目")

# 列表变量
set(SOURCES
    src/main.cpp
    src/utils.cpp
    src/network.cpp
)

# 缓存变量（用户可配置）
set(ENABLE_LOGGING ON CACHE BOOL "是否启用日志")

# 读取环境变量
if(DEFINED ENV{EXTRA_INCLUDE_PATH})
    include_directories($ENV{EXTRA_INCLUDE_PATH})
    message(STATUS "使用了额外的包含路径: $ENV{EXTRA_INCLUDE_PATH}")
endif()

# 条件编译
if(ENABLE_LOGGING)
    list(APPEND SOURCES src/logger.cpp)
    add_definitions(-DENABLE_LOGGING)
endif()

add_executable(${PROJECT_NAME} ${SOURCES})

# 子目录示例
add_subdirectory(lib)
target_link_libraries(${PROJECT_NAME} PRIVATE mylib)

💡 我的建议： 在实际项目中，我习惯把可配置的选项都做成缓存变量，放在CMakeLists.txt的开头。这样用户一看就知道有哪些开关可以调，也方便在cmake-gui里可视化配置。

1.7 避坑指南

最后分享几个我亲身经历过的坑：

变量名大小写：CMake变量名是大小写敏感的。我见过有人写${project_name}但定义的是PROJECT_NAME，结果死活取不到值。
缓存变量覆盖：如果你用set(... CACHE ...)，但缓存里已经有这个变量了，CMake不会覆盖它。除非你加FORCE参数。
环境变量修改：记住，set(ENV{...})只影响当前CMake进程。如果你需要永久修改环境变量，得在shell里做。
列表中的空元素：set(LIST "a;;b")会产生三个元素，中间那个是空字符串。这在循环遍历时容易出问题。

好了，变量与类型这部分就聊到这儿。记住一句话：CMake里一切都是字符串，只是表现形式不同。理解了这一点，后面的学习会顺畅很多。

📚 课程目录

第1章：变量与类型——CMake构建系统的基石

1.1 字符串变量：最基础的存在

1.2 列表变量：用分号分隔的字符串

1.3 缓存变量：跨文件共享的秘密

1.4 环境变量：与操作系统打交道

1.5 变量的作用域：层级与隔离

1.6 实战：一个完整的例子

1.7 避坑指南