跨平台合并多目录OBJECT库至单一库的CMake技术问询

首先明确：CMake的OBJECT库特性从2.8.8版本开始就被支持，Windows（MSVC、MinGW）、Linux（GCC、Clang）、macOS（Clang）等主流平台都能完美适配。OBJECT库的核心优势就是允许每个子模块用独立的编译选项编译成目标文件集合，最后再将这些目标文件打包成单一的静态/动态库，完全匹配你的需求。

针对你参考帖子后仍未解决问题的情况，我给你一套分步实现的方案，帮你避开常见坑：

第一步：子目录的OBJECT目标配置 #

每个子目录的CMakeLists.txt只需要创建OBJECT类型的库，而非静态/动态库，这样就能独立设置编译选项：

# 示例：src/moduleA/CMakeLists.txt
add_library(moduleA_obj OBJECT
    moduleA.cpp
    moduleA.h
)
# 子模块专属编译选项（PRIVATE只作用于当前目标）
target_compile_options(moduleA_obj PRIVATE
    $<$<CXX_COMPILER_ID:GNU,Clang>:-Wall -Wextra -O3>
    $<$<CXX_COMPILER_ID:MSVC>:/W4 /O2>
)
# 导出子模块的头文件路径，方便主库或其他依赖使用
target_include_directories(moduleA_obj PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

第二步：主CMakeLists.txt合并OBJECT目标 #

在根目录的CMakeLists.txt中，先引入所有子目录，再将所有OBJECT目标的文件集合合并成最终的库：

# 根目录CMakeLists.txt
cmake_minimum_required(VERSION 3.10) # 建议用3.10+，兼容性更强
project(CombinedLibrary)

# 引入所有子模块
add_subdirectory(src/moduleA)
add_subdirectory(src/moduleB)
add_subdirectory(src/moduleC)

# 合并成静态库（如果需要动态库，把STATIC改成SHARED即可）
add_library(MyCombinedLib STATIC
    $<TARGET_OBJECTS:moduleA_obj>
    $<TARGET_OBJECTS:moduleB_obj>
    $<TARGET_OBJECTS:moduleC_obj>
)

# 关键：将子模块的头文件路径传递给最终库，确保依赖它的项目能找到头文件
target_link_libraries(MyCombinedLib PUBLIC
    moduleA_obj
    moduleB_obj
    moduleC_obj
)

常见问题排查（你可能踩的坑） #

• CMake版本过低：如果你的CMake版本低于2.8.8，OBJECT库特性不支持，建议升级到3.x版本；
• 动态库的符号导出问题：如果合并成动态库，Windows平台需要确保子模块的符号被正确导出。可以在主库中定义导出宏，比如：

  target_compile_definitions(MyCombinedLib PRIVATE MY_LIB_EXPORT)
  

  然后在子模块的头文件中添加：

  #ifdef _WIN32
  #ifdef MY_LIB_EXPORT
  #define MY_API __declspec(dllexport)
  #else
  #define MY_API __declspec(dllimport)
  #endif
  #else
  #define MY_API
  #endif
  
  // 子模块的函数/类前加MY_API
  MY_API void moduleA_func();
  

• 编译选项的跨平台适配：不同编译器的编译选项语法不同，一定要用CMake的$<CXX_COMPILER_ID>条件判断来适配（像示例中那样）；
• 混淆静态库和OBJECT库的用法：你参考的帖子是合并静态库，而我们用的是直接合并目标文件，两者逻辑不同，不要把静态库的合并代码套用到OBJECT库上。

如果还有具体的错误信息（比如编译报错、链接错误），可以补充出来，我再帮你针对性解决。

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