使用FORCE缓存设置CMake变量首次运行未更新问题求助

问题现象 #

通过环境变量compiler_version=clang15设置CMake变量并缓存，首次执行cmake ..时：

• 输出中compiler_version仍显示默认值gcc
• 缓存文件内已写入正确的clang15值
  当缓存文件存在时重新运行cmake ..，变量则正常显示为clang15

环境信息 #

• 操作系统：Linux
• CMake版本：3.26
• 环境变量配置：export compiler_version=clang15

测试代码（CMakeLists.txt） #

cmake_minimum_required(VERSION 3.26)
project(test)

if(NOT compiler_version)
    set(compiler_version "gcc")
    message("++++++++++++++++++++++++++++++ default ${compiler_version}")
endif()

if(NOT "$ENV{compiler_version}" STREQUAL "")
    set(compiler_version $ENV{compiler_version} CACHE STRING "which compiler to use..." FORCE)
    message("++++++++++++++++++++++++++ env compiler_version : $ENV{compiler_version} cmake_compiler_version  ${compiler_version} ++++++++++++++++++++++++++++")
elseif(NOT compiler_version)
    set(compiler_version "gcc" CACHE STRING "which compiler to use..." FORCE)
    message("++++++++++++++++++++++++++++++ else if ${compiler_version}")
else()
    set(compiler_version ${compiler_version} CACHE STRING "which compiler to use..." FORCE)
    message("++++++++++++++++++++++++++++++ else ${compiler_version}")
endif()

运行输出 #

首次运行（无缓存） #

-- The C compiler identification is GNU 8.5.0
-- The CXX compiler identification is GNU 8.5.0
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /usr/bin/cc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
++++++++++++++++++++++++++++++ default gcc
++++++++++++++++++++++++++ env compiler_version : clang15 cmake_compiler_version  gcc ++++++++++++++++++++++++++++
-- Configuring done (0.6s)
-- Generating done (0.0s)
-- Build files have been written to: /test/build

二次运行（缓存已存在） #

++++++++++++++++++++++++++ env compiler_version : clang15 cmake_compiler_version  clang15 ++++++++++++++++++++++++++++
-- Configuring done (0.0s)
-- Generating done (0.0s)

原因解析 #

这是CMake变量优先级和缓存更新时机的特性导致的：

1. 首次运行无缓存时，CMake先执行第一个if(NOT compiler_version)分支，创建了一个本地变量compiler_version=gcc。
2. 后续执行环境变量判断分支时，set(... CACHE ... FORCE)确实将缓存变量compiler_version设置为clang15，但CMake中本地变量的优先级高于缓存变量——当前作用域已经存在同名本地变量，所以message输出的是本地变量值gcc，而非刚更新的缓存值。
3. 二次运行时，CMake会先加载缓存中的compiler_version=clang15，此时第一个if(NOT compiler_version)分支不触发，没有本地变量生成；执行环境变量分支时，缓存变量被更新，且没有本地变量覆盖，message输出的就是缓存变量的clang15。

修复方案 #

调整代码逻辑，优先处理环境变量，避免本地变量覆盖缓存值，推荐两种写法：

写法一：优先读取环境变量，再设置默认值 #

cmake_minimum_required(VERSION 3.26)
project(test)

# 先处理环境变量，直接初始化缓存
if(NOT "$ENV{compiler_version}" STREQUAL "")
    set(compiler_version "$ENV{compiler_version}" CACHE STRING "which compiler to use..." FORCE)
    message("++++++++++++++++++++++++++ env compiler_version : $ENV{compiler_version} cmake_compiler_version  ${compiler_version} ++++++++++++++++++++++++++++")
else()
    # 环境变量不存在时设置默认缓存值
    set(compiler_version "gcc" CACHE STRING "which compiler to use..." FORCE)
    message("++++++++++++++++++++++++++++++ default ${compiler_version}")
endif()

写法二：显式同步缓存值到本地变量 #

如果要保留原有逻辑结构，可在更新缓存后，显式将缓存值同步到本地变量：

cmake_minimum_required(VERSION 3.26)
project(test)

if(NOT compiler_version)
    set(compiler_version "gcc")
    message("++++++++++++++++++++++++++++++ default ${compiler_version}")
endif()

if(NOT "$ENV{compiler_version}" STREQUAL "")
    set(compiler_version $ENV{compiler_version} CACHE STRING "which compiler to use..." FORCE)
    # 同步缓存值到本地变量
    set(compiler_version "${compiler_version}")
    message("++++++++++++++++++++++++++ env compiler_version : $ENV{compiler_version} cmake_compiler_version  ${compiler_version} ++++++++++++++++++++++++++++")
elseif(NOT compiler_version)
    set(compiler_version "gcc" CACHE STRING "which compiler to use..." FORCE)
    message("++++++++++++++++++++++++++++++ else if ${compiler_version}")
else()
    set(compiler_version ${compiler_version} CACHE STRING "which compiler to use..." FORCE)
    message("++++++++++++++++++++++++++++++ else ${compiler_version}")
endif()

内容的提问来源于stack exchange，提问作者Sanket Bhurke