基于CMake的C++20项目链接时main_tests.cpp.o格式识别失败求助

CMake构建的C++20项目偶尔出现链接错误：

CMakeFiles/reinforce_tests_all.dir/test/main_tests.cpp.o: file not recognized: file format not recognized

此前清理构建目录重新构建可解决，但本次问题持续存在。用file命令检查目标文件，显示为LLVM IR bitcode，链接器为GNU ld 2.38。

运行环境 #

• 架构：arm64 macOS，运行arm64 Ubuntu 22.04 Docker镜像
• 编译器：已安装GCC-13和clang-16（当前使用clang-16编译）

编译命令片段（来自compile_commands.json） #

{
  "directory": "/tmp/reinforce/cmake-build-debug-docker-clang-reinforce",
  "command": "/usr/bin/clang++ -DHAVE_CBLAS=1 -DSPDLOG_ACTIVE_LEVEL=SPDLOG_LEVEL_DEBUG -DSPDLOG_COMPILED_LIB -DSPDLOG_FMT_EXTERNAL -DXTENSOR_USE_XSIMD -I/tmp/reinforce/src/libreinforce/include -I/tmp/reinforce/test/shared_test_utils -isystem /home/root/conan_cache/p/pcg-c4aa2cafcf36e3/p/include -isystem /home/root/conan_cache/p/range0301bf3d76d5d/p/include -isystem /home/root/conan_cache/p/b/fmted8c40f5dd02d/p/include -isystem /home/root/conan_cache/p/xtens8c3f32033d144/p/include -isystem /home/root/conan_cache/p/xtl7161fe009dc21/p/include -isystem /home/root/conan_cache/p/nlohm0567ffc90cfc1/p/include -isystem /home/root/conan_cache/p/xsimd7b0628df207bb/p/include -isystem /home/root/conan_cache/p/b/spdlo0e2ce77e2e884/p/include -isystem /home/root/conan_cache/p/froze7ac551bf2fb61/p/include -isystem /tmp/reinforce/cmake-build-debug-docker-clang-reinforce/_deps/xtensor-python-src/include -isystem /home/root/conan_cache/p/pybin895b9560d7d3f/p/include -isystem /usr/include/python3.10 -isystem /usr/local/lib/python3.10/dist-packages/numpy/core/include -isystem /tmp/reinforce/cmake-build-debug-docker-clang-reinforce/_deps/xtensor-blas-src/include -isystem /home/root/conan_cache/p/b/gtest79f180a2a4833/p/include -g -std=gnu++20 -fcolor-diagnostics -g3 -ftemplate-backtrace-limit=0 -flto=auto -funroll-loops -Wall -Wextra -Wshadow -Wnon-virtual-dtor -Wold-style-cast -Wcast-align -Wunused -Woverloaded-virtual -Wpedantic -Wconversion -Wsign-conversion -Wnull-dereference -Wdouble-promotion -Wformat=2 -Winvalid-pch -Xclang -include-pch -Xclang /tmp/reinforce/cmake-build-debug-docker-clang-reinforce/CMakeFiles/reinforce_tests_gridworld.dir/cmake_pch.hxx.pch -Xclang -include -Xclang /tmp/reinforce/cmake-build-debug-docker-clang-reinforce/CMakeFiles/reinforce_tests_gridworld.dir/cmake_pch.hxx -o CMakeFiles/reinforce_tests_gridworld.dir/test/main_tests.cpp.o -c /tmp/reinforce/test/main_tests.cpp",
  "file": "/tmp/reinforce/test/main_tests.cpp",
  "output": "CMakeFiles/reinforce_tests_gridworld.dir/test/main_tests.cpp.o"
}

核心原因分析 #

目标文件是LLVM IR bitcode格式，而GNU ld无法直接处理这种格式，必须通过LLVM的lld链接器或者让clang在编译时直接生成机器码而非bitcode。结合编译命令中的-flto=auto参数，问题大概率出在LTO配置和链接器不匹配上。

具体解决步骤 #

• 强制使用clang的链接器：在CMake中配置使用lld而非GNU ld。添加以下CMake代码：

  set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fuse-ld=lld")
  set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -fuse-ld=lld")
  

  或者在运行CMake时通过参数指定：

  cmake .. -DCMAKE_EXE_LINKER_FLAGS="-fuse-ld=lld" -DCMAKE_SHARED_LINKER_FLAGS="-fuse-ld=lld"
  

• 禁用LTO（临时验证用）：如果暂时不需要LTO，可关闭该选项确认问题是否消失。在CMake中设置：

  set(CMAKE_INTERPROCEDURAL_OPTIMIZATION OFF)
  

  或者通过命令行参数：

  cmake .. -DCMAKE_INTERPROCEDURAL_OPTIMIZATION=OFF
  

• 检查PCH与LTO的兼容性：编译命令中使用了预编译头（PCH），同时开启LTO可能存在兼容性问题。尝试禁用PCH，或者清理PCH缓存后重新构建：

  rm -rf CMakeFiles/*/*.pch
  

• 彻底清理构建缓存：除了删除构建目录，还要清理Conan缓存中可能存在的不兼容二进制文件：

  conan cache clean -f
  

  然后重新生成构建文件并编译。

• 确认编译器与链接器的一致性：确保所有目标文件都由clang编译，避免混合使用GCC和clang编译的目标文件。检查CMake的CMAKE_CXX_COMPILER是否正确设置为clang++：

  set(CMAKE_CXX_COMPILER "/usr/bin/clang++")
  

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