如何在CMake预设中设置标志缓存变量而不覆盖已有值？

我尝试遵循CMake最佳实践，希望实现以下分层管理逻辑：

• 工具链特定标志放在工具链文件中
• 项目特定标志放在CMakeLists.txt中
• 可选警告标志放在CMakePresets.json中

当前配置与问题 #

现有文件内容 #

1. 工具链文件（toolchain.cmake）：

set(CMAKE_CXX_FLAGS_INIT "-mthumb -mcpu=cortex-m4")

2. CMakeLists.txt：

set(CMAKE_CXX_FLAGS  "${CMAKE_CXX_FLAGS} -fno-exceptions")

3. CMakePresets.json：

{
    "version": 3,
    "configurePresets": [
        {
            "name": "debug",
            "generator": "Ninja",
            "binaryDir": "${sourceDir}/build/${presetName}",
            "toolchainFile": "${sourceDir}/cmake/toolchain.cmake",
            "cacheVariables": {
                "CMAKE_EXPORT_COMPILE_COMMANDS": "ON",
                "CMAKE_BUILD_TYPE": "Debug",
                "CMAKE_CXX_FLAGS": "-Wall -Wextra"
            }
        }
    ]
}

问题现象 #

预设中直接设置CMAKE_CXX_FLAGS会覆盖工具链文件里的CMAKE_CXX_FLAGS_INIT值，最终生成的标志为-Wall -Wextra -fno-exceptions，工具链指定的-mthumb -mcpu=cortex-m4完全丢失。手动在CMakeLists.txt中拼接CMAKE_CXX_FLAGS_INIT的方式不够合理，不符合分层管理的初衷。

正确的分层配置方案 #

1. 工具链文件：保留初始化逻辑 #

工具链文件继续使用CMAKE_CXX_FLAGS_INIT设置专属标志，这是CMake初始化缓存变量的标准方式：

set(CMAKE_CXX_FLAGS_INIT "-mthumb -mcpu=cortex-m4")

2. 预设文件：通过CMAKE_CXX_FLAGS_INIT追加可选标志 #

在CMakePresets.json中，不要直接覆盖CMAKE_CXX_FLAGS，而是通过追加CMAKE_CXX_FLAGS_INIT来添加可选警告标志，确保工具链的初始化值被保留：

{
    "version": 3,
    "configurePresets": [
        {
            "name": "debug",
            "generator": "Ninja",
            "binaryDir": "${sourceDir}/build/${presetName}",
            "toolchainFile": "${sourceDir}/cmake/toolchain.cmake",
            "cacheVariables": {
                "CMAKE_EXPORT_COMPILE_COMMANDS": "ON",
                "CMAKE_BUILD_TYPE": "Debug",
                "CMAKE_CXX_FLAGS_INIT": "$env{CMAKE_CXX_FLAGS_INIT} -Wall -Wextra"
            }
        }
    ]
}

这里通过$env{CMAKE_CXX_FLAGS_INIT}引用工具链中已设置的初始化值，实现安全追加。

3. CMakeLists.txt：稳妥追加项目特定标志 #

在CMakeLists.txt中，明确操作缓存变量来追加项目专属标志，避免被后续逻辑覆盖：

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fno-exceptions" CACHE STRING "C++ compiler flags" FORCE)

添加CACHE ... FORCE确保修改写入缓存，普通场景下直接拼接也能生效，但明确指定缓存会更稳妥。

核心原理 #

• CMAKE_CXX_FLAGS_INIT是CMake的标准初始化变量，优先级逻辑为：工具链文件设置 → 预设文件追加 → CMake自动初始化生成CMAKE_CXX_FLAGS
• 直接在预设中设置CMAKE_CXX_FLAGS会跳过初始化流程，直接覆盖缓存值，导致工具链标志丢失
• 通过预设修改CMAKE_CXX_FLAGS_INIT，CMake会自动合并所有初始化值到CMAKE_CXX_FLAGS，再由CMakeLists.txt追加项目标志，完美实现分层管理

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