option不是声明而是缓存注册，仅首次生效；改默认值不覆盖已有缓存值，需删CMakeCache.txt或用-D重设；option强制BOOL类型且GUI识别为复选框，而set(...CACHE)无类型校验；须用target_compile_definitions()将option转为预处理器宏。

option 不是开关变量的“声明”，而是缓存变量的注册动作——它只在首次配置时生效，后续再运行 cmake 时，只要 CMakeCache.txt 里已有同名变量，就完全忽略你写的默认值。

为什么 option(ENABLE_LOGGING "Enable logging" ON) 有时不生效？

常见现象：改了 initial_value（比如从 OFF 改成 ON），重新跑 cmake ..，但 ENABLE_LOGGING 还是 OFF。

• option() 不会覆盖已存在的缓存值；它只在变量未定义时才写入默认值
• 哪怕你在 CMakeLists.txt 里把默认值改成 ON，只要 CMakeCache.txt 里还存着 ENABLE_LOGGING:BOOL=OFF，CMake 就照读不误
• 想重置，必须删掉 CMakeCache.txt，或显式用 -DENABLE_LOGGING=ON 覆盖
• 检查当前值：打开 CMakeCache.txt 搜索 ENABLE_LOGGING，或运行 cmake -LH .. 查看所有缓存项及其说明

option 和 set(... CACHE) 的区别在哪？

两者都写缓存，但语义和行为不同：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• option(USE_OPENMP "Enable OpenMP" OFF) 等价于 set(USE_OPENMP OFF CACHE BOOL "Enable OpenMP")，但前者更明确表达“这是用户可调的布尔开关”
• option 强制变量类型为 BOOL；set(... CACHE) 不校验类型，容易误设成字符串（如 "on" 或 1），导致 if(USE_OPENMP) 判定失败
• GUI 工具（如 cmake-gui）只识别 option 定义的项并显示为复选框；set(... CACHE) 若类型不是 BOOL，就只当普通文本框
• 如果变量名冲突（比如之前用 set(FORCE_BUILD CACHE STRING) 定义过），再写 option(FORCE_BUILD ...) 会被静默忽略

怎么让 C++ 源码感知 option 开关？

不能直接在 .cpp 文件里写 #ifdef ENABLE_LOGGING —— option 本身不自动注入预处理器宏。

• 必须手动用 target_compile_definitions() 把开关转成宏：

  option(ENABLE_LOGGING "Enable logging" OFF)
  if(ENABLE_LOGGING)
    target_compile_definitions(myapp PRIVATE ENABLE_LOGGING)
  endif()

• 避免用过时的 add_definitions()，它作用于全局，会影响所有 target，且无法按 target 细粒度控制
• 如果多个 target 需要同一宏，别重复写 target_compile_definitions，可统一用 add_compile_options(-DENABLE_LOGGING)（但推荐前者）
• 宏名大小写建议全大写（如 ENABLE_LOGGING），和 option 变量名保持一致，减少混淆

真正容易被忽略的是缓存持久性：一次 cmake -DBUILD_TESTS=OFF .. 之后，除非删 cache 或再加 -D，否则 BUILD_TESTS 就永远是 OFF —— 这不是 bug，是设计。你得习惯把 CMakeCache.txt 当作配置快照来管理，而不是每次重来。