CMake多子项目引用头文件库时重复定义问题求解

你遇到的"already defined"冲突，核心原因是辅助库C的头文件里包含了函数/变量的实现代码，而非仅声明。头文件保护（#ifndef...）只能避免单个编译单元内的重复包含，但每个引用C的源文件（比如A、B中的cpp）都会把头里的实现编译一遍，链接时就会出现多个相同符号的定义冲突。

下面是两种针对性解决方案：

方案一：将C改为静态/动态库（推荐，适合含较多实现代码的场景） #

• 步骤1：拆分头文件与实现代码
  把C头文件里的函数实现、全局变量定义移到新建的源文件（.cpp/.c）中，头文件仅保留声明和数据结构定义：

  // c_utils.h（头文件）
  #ifndef C_UTILS_H
  #define C_UTILS_H
  
  // 函数声明
  int add(int a, int b);
  // 数据结构定义
  typedef struct {
      int x;
      int y;
  } Point;
  
  #endif
  

  // c_utils.cpp（实现文件）
  #include "c_utils.h"
  
  int add(int a, int b) {
      return a + b;
  }
  

• 步骤2：修改C子项目的CMakeLists.txt
  替换原来的INTERFACE库为静态/动态库：

  # 替换add_library(lib_c INTERFACE)
  add_library(lib_c STATIC c_utils.cpp) # 用SHARED可生成动态库，按需选择
  target_include_directories(lib_c PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}/path/to/headers")
  

  这里用PUBLIC是让引用lib_c的目标（A、B）自动继承头文件路径，无需单独配置。
• 步骤3：在A、B的CMakeLists.txt中链接lib_c

  # 以A为可执行文件为例
  add_executable(A main.cpp [其他源文件])
  target_link_libraries(A PRIVATE lib_c)
  

  这样每个目标只会链接一次lib_c的二进制代码，不会出现重复定义。

方案二：将头文件内的实现改为inline（适合简单工具函数） #

如果C的函数都是轻量工具函数，可以用inline关键字修饰实现，让编译器将函数内联到调用处，避免生成独立符号：

• 修改头文件中的函数实现：

  #ifndef C_UTILS_H
  #define C_UTILS_H
  
  inline int add(int a, int b) {
      return a + b;
  }
  
  typedef struct {
      int x;
      int y;
  } Point;
  
  #endif
  

• 保持C的CMakeLists.txt不变，但调整target_include_directories为PUBLIC：

  add_library(lib_c INTERFACE)
  target_include_directories(lib_c PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}/path/to/headers")
  

• A、B的CMakeLists.txt仍用target_link_libraries引用：

  target_link_libraries(A PRIVATE lib_c)
  

额外注意事项 #

• 禁止在头文件中定义全局变量（如int global_val = 0;），若必须使用，需在头文件用extern声明，在源文件中定义（对应方案一）。
• 单个子项目多次引用lib_c无需额外处理，CMake会自动管理依赖，不会重复链接。

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