CMAKE_CXX_FLAGS未传递给编译器：原因及解决方法

我通过命令行设置CMAKE_CXX_FLAGS传递编译器参数，命令如下：

$ CC=my_llvm/clang CC=my_llvm/clang++ \
  cmake -DCMAKE_AR=my_llvm/llvm-ar -DCMAKE_LD=my_llvm/lld \
  -DCMAKE_CXX_FLAGS=--target=aarch64-linux-android34 -S src_dir -B build_dir

根据CMAKE_<LANG>_FLAGS官方文档，这些标志应传递给所有编译器调用，但实际发现CMAKE_CXX_FLAGS仅存在于CMakeCache.txt中，并未传递给编译器：

$ grep -r CMAKE_CXX_FLAGS build_dir -w
build_dir/CMakeCache.txt:CMAKE_CXX_FLAGS:STRING=--target=aarch64-linux-android34
build_dir/CMakeCache.txt://ADVANCED property for variable: CMAKE_CXX_FLAGS
build_dir/CMakeCache.txt:CMAKE_CXX_FLAGS-ADVANCED:INTERNAL=1

编译器调用时实际使用的是CXX_FLAGS变量：

$ grep -rP 'clang.*CXX_FLAGS' build_dir -w
build_dir/CMakeFiles/xxx.dir/build.make:        my_llvm/clang++ $(CXX_DEFINES) \
  $(CXX_INCLUDES) $(CXX_FLAGS) -MD \
  -MT CMakeFiles/xxx.dir/xxx.cpp.o \
  -MF CMakeFiles/xxx.dir/xxx.cpp.o.d \
  -o CMakeFiles/xxx.dir/xxx.cpp.o -c xxx.cpp

使用的CMake版本为3.22.1：

$ cmake --version
cmake version 3.22.1

CMakeLists.txt内容：

cmake_minimum_required(VERSION 3.8)

project("xxx")

add_library(${CMAKE_PROJECT_NAME} SHARED
        xxx.cpp)

ADD_LIBRARY(abc STATIC
        yyy.cpp)

target_link_libraries(${CMAKE_PROJECT_NAME}
        android
        log
        abc)

原因分析 #

1. 变量展开逻辑：build.make中的CXX_FLAGS是CMake生成的中间变量，它本应包含CMAKE_CXX_FLAGS的内容，但未生效的核心原因是交叉编译环境配置错误。
2. 目标平台参数误用：--target=aarch64-linux-android34属于目标平台专属参数，这类参数应通过CMAKE_CXX_COMPILER_TARGET变量设置，而非直接写入CMAKE_CXX_FLAGS。CMake处理交叉编译时，会优先使用专门的平台变量，直接修改CMAKE_CXX_FLAGS可能被后续配置逻辑覆盖。
3. 环境变量重复赋值：命令中CC被重复赋值（CC=my_llvm/clang CC=my_llvm/clang++），导致C语言编译器被错误设置为C++编译器，干扰了CMake的编译器检测流程，进而影响CMAKE_CXX_FLAGS的正常传递。

解决步骤 #

1. 修正环境变量与参数设置 #

将命令中的CC改为CXX区分C/C++编译器，同时用CMAKE_CXX_COMPILER_TARGET设置目标平台：

$ CC=my_llvm/clang CXX=my_llvm/clang++ \
  cmake -DCMAKE_AR=my_llvm/llvm-ar -DCMAKE_LD=my_llvm/lld \
  -DCMAKE_CXX_COMPILER_TARGET=aarch64-linux-android34 -S src_dir -B build_dir

2. 验证参数生效情况 #

重新生成构建文件后，检查编译命令是否包含目标参数：

# 检查FLAGS中是否包含目标参数
grep -r "--target=aarch64-linux-android34" build_dir/CMakeFiles/
# 或查看实际编译命令
cd build_dir && make -n

若编译命令中出现--target=aarch64-linux-android34，说明参数已生效。

3. 备选方案：强制初始化FLAGS #

若上述方法无效，可使用CMAKE_CXX_FLAGS_INIT在CMake初始化阶段设置参数，避免被后续逻辑覆盖：

$ CC=my_llvm/clang CXX=my_llvm/clang++ \
  cmake -DCMAKE_AR=my_llvm/llvm-ar -DCMAKE_LD=my_llvm/lld \
  -DCMAKE_CXX_FLAGS_INIT="--target=aarch64-linux-android34" -S src_dir -B build_dir

也可直接在CMakeLists.txt中追加参数（若允许修改配置文件）：

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} --target=aarch64-linux-android34")

命令行传递编译器参数的正确方式 #

1. 平台专属参数：使用CMake提供的专用变量，例如：
   • 目标平台：CMAKE_CXX_COMPILER_TARGET（对应编译器--target参数）
   • C++标准：CMAKE_CXX_STANDARD
2. 通用编译标志：
   • 传递多参数时需用引号包裹，例如：-DCMAKE_CXX_FLAGS="-O2 -Wall"
   • 初始化阶段优先使用CMAKE_<LANG>_FLAGS_INIT，避免被后续配置覆盖
3. 交叉编译场景：推荐使用工具链文件集中管理配置，创建android.toolchain.cmake：

   set(CMAKE_C_COMPILER my_llvm/clang)
   set(CMAKE_CXX_COMPILER my_llvm/clang++)
   set(CMAKE_AR my_llvm/llvm-ar)
   set(CMAKE_LD my_llvm/lld)
   set(CMAKE_CXX_COMPILER_TARGET aarch64-linux-android34)
   

   命令行调用：

   cmake -DCMAKE_TOOLCHAIN_FILE=android.toolchain.cmake -S src_dir -B build_dir
   

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