CMake工具链文件设置CMAKE_CXX_FLAGS的写法差异与选择

在工具链文件编写场景下，必须使用带缓存强制覆写的第一种写法，第二种普通变量追加写法是错误用法，会导致架构参数失效、编译探测失败等问题。

你提到的两种写法分别是：
写法1（工具链场景正确写法）：

SET(CMAKE_CXX_FLAGS "-m32" CACHE STRING "C++ compiler flags" FORCE)

写法2（工具链场景错误写法）：

SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -m32")

两种写法的核心差异 #

• 生效阶段与作用域不同
  CMake加载工具链文件的时机远早于项目配置流程：加载工具链时，CMake还未完成编译器自动探测、默认编译参数初始化、目标ABI校验等核心前置步骤。
  写法1直接将CMAKE_CXX_FLAGS写入CMake全局缓存，属于持久化的全局配置，后续所有编译器探测、试编译、项目编译链接环节都会读取这个缓存值，-m32这类架构切换参数会全程生效，不会出现32位目标链接64位系统库、编译器探测失败的问题。
  写法2设置的是当前作用域的普通局部变量，工具链加载完成后，CMake初始化默认CMAKE_CXX_FLAGS缓存变量时会直接覆盖这个局部值，你追加的-m32会直接丢失；就算没有被覆盖，普通变量也不会传递给CMake内置的前置探测流程，会导致前置校验通过但实际编译时架构不匹配的诡异问题。
• 参数重复风险不同
  写法2采用追加拼接的逻辑，当CMake多次执行配置、或者工具链被重复引入时，-m32会被反复拼接到参数列表中，最终编译命令里会出现多次重复的-m32标记，不仅让编译命令冗余杂乱，部分对参数顺序敏感的编译场景下还会触发解析错误。
  写法1是强制覆写缓存值，无论配置执行多少次、工具链被加载多少次，缓存中对应的值只会保留一次设置的-m32，不会出现参数重复的问题。
• 配置可见性不同
  写法1明确声明了缓存变量的类型为字符串，附带参数说明，用户后续通过cmake-gui、ccmake等可视化配置工具调整参数时，可以直接在配置列表中看到这个编译选项，直观调整或排查问题，符合CMake的配置交互规范。
  写法2设置的普通局部变量不会出现在缓存配置列表中，用户无法通过交互工具感知到该参数的存在，后续排查编译参数问题时很难定位到工具链中的隐式设置。

补充说明：上述结论仅针对工具链文件场景。如果是在项目自身的CMakeLists.txt中添加编译参数，不建议直接修改全局CMAKE_CXX_FLAGS，更推荐使用target_compile_options针对具体目标设置参数，避免参数全局污染。

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