set命令分普通变量、缓存变量、环境变量三类，作用域与覆盖规则各异：普通变量仅当前及子目录生效且不自动追加；缓存变量需FORCE才可覆盖并持久化至CMakeCache.txt；环境变量用set(ENV{...})设置，影响后续命令；PARENT_SCOPE仅对直接父级有效，宏中无效。
set 不是“随便赋值就完事”的命令，它分普通变量、缓存变量、环境变量三类，作用域和覆盖行为完全不同——用错一类，轻则变量不生效，重则 CMakeCache.txt 被意外改写、构建行为不可复现。
普通变量赋值：只在当前及子目录生效，空格和分号等价
普通变量用于内部逻辑，比如收集源文件、拼路径。关键点是：set 后面多个值默认用分号连接成一个字符串（不是数组），${VAR} 展开后仍是单个字符串，但 add_executable 等命令会自动按分号拆成列表。
-
set(SOURCES main.cpp utils.cpp)和set(SOURCES "main.cpp;utils.cpp")效果一样，${SOURCES}值都是main.cpp;utils.cpp - 多次
set(SOURCES ...)以最后一次为准，不会追加；要追加得用list(APPEND SOURCES new.cpp) - 子目录通过
add_subdirectory()引入时能继承该变量；但函数内定义的普通变量默认不出作用域，除非加PARENT_SCOPE - 别在普通变量里写带空格的路径而不加引号：
set(INC_DIR /usr/include/my lib)会被截断为/usr/include/my，正确写法是set(INC_DIR "/usr/include/my lib")
缓存变量设置：用户可改、写入 CMakeCache.txt，FORCE 才能覆盖
缓存变量用于配置开关或外部路径（如 CMAKE_BUILD_TYPE），它的值会持久化到 CMakeCache.txt，下次运行 cmake 不加 -D 就沿用旧值。不加 FORCE 时，用户手动设置过就不会被 set 覆盖。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
set(BUILD_TESTS ON CACHE BOOL "Enable tests")：首次运行会写入缓存，之后再执行这条命令无效，除非加FORCE -
set(CMAKE_CXX_STANDARD 17 CACHE STRING "" FORCE)：强制覆盖，适合项目统一标准，避免用户误设 - 类型必须明确：
BOOL、STRING、PATH、FILEPATH，类型错会导致 GUI 显示异常或值被忽略 - 文档字符串（
docstring）不能为空，否则缓存条目可能不显示在 cmake-gui 中
PARENT_SCOPE 和作用域陷阱：子目录改不了父目录变量
普通变量默认只能向下传递（父 → 子），不能反向。想让子目录“回调”修改父目录变量，必须显式用 PARENT_SCOPE，且仅对当前作用域的上一层生效。
-
set(OUTPUT_DIR "${CMAKE_BINARY_DIR}/bin" PARENT_SCOPE)在子目录CMakeLists.txt里执行，会让父目录的OUTPUT_DIR变量变成这个值 - 但当前子目录里
${OUTPUT_DIR}仍为旧值（或未定义），PARENT_SCOPE不影响本层 - 嵌套两层以上时，
PARENT_SCOPE只跳一级，不能跨多层；需要逐级传递或改用缓存变量 - 函数内使用
PARENT_SCOPE是安全的；但在宏（macro）里无效，因为宏不创建新作用域
环境变量和 unset：临时改 PATH 或清理变量
用 set(ENV{...}) 改环境变量只影响后续执行的命令（如 find_package、execute_process），不影响 shell 本身；unset 虽然没列在标题里，但它是 set 的隐式搭档——给变量赋零个值就等于 unset。
-
set(ENV{PKG_CONFIG_PATH} "${CMAKE_SOURCE_DIR}/3rdparty/lib/pkgconfig")：让find_package能找到本地 pkg-config 模块 -
set(MY_VAR)：清空MY_VAR，等价于unset(MY_VAR)，注意不是set(MY_VAR "")（后者赋空字符串） -
set(ENV{LD_LIBRARY_PATH} "$ENV{LD_LIBRARY_PATH}:/my/lib")：拼接环境变量，但需确保原值存在，否则会出错；更稳妥写法是先if(DEFINED ENV{LD_LIBRARY_PATH})判断
最易被忽略的是缓存变量的“静默失效”——你以为 set(... CACHE ...) 每次都生效，其实它只在第一次或加 FORCE 时起作用；还有 PARENT_SCOPE 在宏里完全不工作，而很多人误以为宏和函数一样。
