cmake中变量用set()定义、${var_name}读取，漏花括号会字面处理；环境变量用$env{name}，缓存变量用${name}；作用域默认限于当前及子目录，需parent_scope传递；优先使用option()和find_package()替代手动set()以提升可维护性。
变量怎么在 CMakeLists.txt 里定义和读取？
CMake 的变量不是写 var=xxx 那种，得用 set() 定义，用 ${VAR_NAME} 展开。漏掉花括号会直接当字面量处理，比如写 include_directories($ENV_HOME) 就啥也不生效——它真以为你要加一个叫 "$ENV_HOME" 的目录。
-
set(MY_LIB_DIR "/usr/local/lib")定义变量 -
include_directories(${MY_LIB_DIR})正确展开 -
message(STATUS "Path: ${MY_LIB_DIR}")调试时打印值 - 变量作用域默认是当前目录及子目录，
set(... PARENT_SCOPE)才能传给父级
环境变量和缓存变量怎么取？
环境变量走 $ENV{PATH}，缓存变量（比如 cmake -DXXX=ON 传进来的）用 ${XXX} 直接读。但注意：缓存变量一旦写入 CMakeCache.txt，下次运行不加 -D 不会变；而环境变量每次都会重新读。
-
set(CMAKE_BUILD_TYPE "Release" CACHE STRING "Build type")声明缓存变量 -
if($ENV{CI} STREQUAL "true")判断 CI 环境 -
if(NOT DEFINED MY_OPTION)检查变量是否已定义，避免未初始化误用
引用变量时常见的拼写和作用域坑
大小写敏感、下划线位置错、多了一层引号，都可能导致变量为空或报错。更隐蔽的是子目录里改了变量，父目录看不到——CMake 默认不自动继承修改。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 写
${CMAKE_SOURCE_DIR}别写成${CMAKE_SOURCEDIR}（少个下划线） -
add_subdirectory(src)后，在src/CMakeLists.txt里改set(FOO bar)，外层仍读不到${FOO} - 字符串拼接别裸写：
"${CMAKE_BINARY_DIR}/output"正确，${CMAKE_BINARY_DIR}/output在某些上下文里可能被截断 -
message(WARNING "${NOT_EXIST_VAR}")不报错，但输出空字符串，容易误判
要不要用 option() 或 find_package() 替代手写变量？
如果变量代表开关（如是否启用测试）或外部依赖路径，优先用 option() 和 find_package()。它们自带缓存、文档提示和跨平台路径处理，比手动 set() 更可靠。
-
option(ENABLE_TESTS "Enable unit tests" OFF)用户能用-DENABLE_TESTS=ON控制 -
find_package(OpenSSL REQUIRED)自动设OpenSSL_INCLUDE_DIRS和OpenSSL_LIBRARIES - 自己硬编码
set(OPENSSL_ROOT_DIR "/opt/openssl")很容易在不同机器上失效
变量引用本身很简单，难的是什么时候该用变量、什么时候该用 CMake 内置机制——尤其当项目开始跨平台或多人协作时，随意 set() 会快速变成维护噩梦。
