MacOS下QT项目CMake编译出现main符号重复链接错误求助

问题背景 #

基于CMakeLists.txt的Qt应用可在Windows和Android平台正常编译构建，但在macOS平台编译时出现以下链接错误：

duplicate symbol '_main' in:
    /Users/admin/dev/repos/tradeclient/src/TradeClient/build/Desktop_x86_darwin_generic_mach_o_64bit/build/TradeClient.build/RelWithDebInfo/Objects-normal/x86_64/CMakeCXXCompilerId.o
    /Users/admin/dev/repos/tradeclient/src/TradeClient/build/Desktop_x86_darwin_generic_mach_o_64bit/build/TradeClient.build/RelWithDebInfo/Objects-normal/x86_64/main.o
ld: 1 duplicate symbols
clang: error: linker command failed with exit code 1 (use -v to see invocation)

经排查，错误来自CMake自动生成的./CMakeFiles/3.29.2/CompilerIdCXX/CMakeCXXCompilerId.cpp文件，该文件包含独立的main函数：

int main(int argc, char* argv[])
{
  int require = 0;
  require += info_compiler[argc];
  require += info_platform[argc];
  require += info_arch[argc];
#ifdef COMPILER_VERSION_MAJOR
  require += info_version[argc];
#endif
#ifdef COMPILER_VERSION_INTERNAL
  require += info_version_internal[argc];
#endif
#ifdef SIMULATE_ID
  require += info_simulate[argc];
#endif
#ifdef SIMULATE_VERSION_MAJOR
  require += info_simulate_version[argc];
#endif
#if defined(__CRAYXT_COMPUTE_LINUX_TARGET)
  require += info_cray[argc];
#endif
  require += info_language_standard_default[argc];
  require += info_language_extensions_default[argc];
  (void)argv;
  return require;
}

CMakeCXXCompilerId.cpp中main函数的作用 #

这个文件是CMake在配置阶段自动生成的编译器检测工具，其中的main函数是该工具的执行入口：

• CMake通过编译运行这个小工具，识别当前编译器的类型、版本、ABI特性、默认语言标准、扩展支持等关键信息
• 函数内的逻辑会根据不同编译宏和参数返回对应值，帮助CMake确认编译器能力，生成适配当前环境的构建配置

为何该文件会被纳入项目编译？ #

正常情况下，CMake生成的CompilerId相关检测目标是独立的，不会参与主项目的链接流程。出现该问题的常见原因：

• Xcode生成器的构建目标逻辑：使用ALL_BUILD目标构建时，Xcode生成器可能错误地将CMake内部的检测目标包含进主项目的链接步骤（Windows/Android的生成器处理逻辑不同，因此未触发该问题）
• 构建缓存残留：旧的构建目录缓存未彻底清理，导致CMake生成的中间目标文件被错误引用
• 版本兼容性问题：CMake 3.29.2与Qt Creator 13在macOS+Xcode环境下的集成可能存在bug，导致目标依赖关系混乱

解决建议 #

• 彻底清理构建目录：删除整个Desktop_x86_darwin_generic_mach_o_64bit构建目录，重新运行CMake配置和构建
• 直接构建主项目目标：将构建命令改为cmake --build /Users/admin/dev/repos/tradeclient/src/TradeClient/build/Desktop_x86_darwin_generic_mach_o_64bit --target TradeClient --config RelWithDebInfo，跳过ALL_BUILD避免引入无关目标
• 检查CMakeLists.txt：确认add_executable仅包含项目自身的源码文件，未意外引入CMakeFiles目录下的内容
• 尝试降级CMake版本：若为版本兼容性问题，切换到更稳定的CMake版本（如3.28.x系列）

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