CMake中C++交叉依赖库出现重定义错误该如何解决？

你遇到的error: redefinition of ‘void lib1()’本质有两个核心原因：

1. 头文件内函数定义重复：Lib1的头文件中直接写了函数实现（而非仅声明），当多个编译单元（比如main.cpp和Lib2的源文件）包含该头文件时，每个单元都会生成一份函数定义，链接时就会出现重定义冲突。
2. CMake循环依赖：Lib1和Lib2互相设置了链接依赖，导致CMake处理依赖时出现逻辑循环，同时也加剧了头文件重复包含的问题。

1. 修复头文件重定义问题 #

因为Lib1仅包含头文件，必须保证头文件中的函数实现不会在多个编译单元生成重复定义，以下两种方案任选其一：

方案A：使用inline关键字 #

将Lib1头文件中的函数实现加上inline修饰，C++标准允许inline函数在多个编译单元存在定义，链接时会自动合并：

// Lib1/lib1.h
#pragma once // 先加头文件保护，避免单次编译单元内重复包含
#include "lib2.h" // 因为要调用Lib2的函数

inline void lib1() {
    // 函数实现
    lib2(); // 调用Lib2的函数
}

方案B：仅保留函数声明（可拆分实现） #

如果允许将Lib1的函数实现移到其他源文件（比如合并到Lib2），则头文件只保留声明：

// Lib1/lib1.h
#pragma once
#include "lib2.h"

void lib1(); // 仅声明

然后在Lib2的某个源文件中实现：

// Lib2/lib2_impl.cpp
#include "../Lib1/lib1.h"

void lib1() {
    // 函数实现
    lib2();
}

2. 修正CMake依赖配置 #

调整两个库的CMake配置，消除循环依赖，同时保证依赖传递正确：

Lib1目录下的CMakeLists.txt（保持INTERFACE库特性） #

add_library(lib1 INTERFACE)

# 让使用lib1的目标能找到Lib1的头文件
target_include_directories(lib1
    INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}
)

# 因为Lib1的头文件依赖Lib2，将Lib2作为INTERFACE依赖传递给所有使用lib1的目标
target_link_libraries(lib1 INTERFACE
    lib2
)

Lib2目录下的CMakeLists.txt（消除循环依赖） #

Lib2仅需要Lib1的头文件用于编译，不需要链接Lib1（因为Lib1是INTERFACE库，无二进制文件），所以用PRIVATE依赖：

add_library(lib2 ${SOURCES} ${HEADERS})

target_include_directories(lib2
    INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}
)

# 仅让Lib2自己能找到Lib1的头文件，不将Lib1的依赖传递给链接Lib2的目标
target_link_libraries(lib2 
    PRIVATE
        lib1
)

根目录下的CMakeLists.txt（简化链接） #

因为Lib1的INTERFACE已经包含了Lib2的依赖，所以只需要链接Lib1即可（如果Main同时需要直接使用Lib2，也可以显式链接，不会冲突）：

add_executable(${PROJECT_NAME} main.cpp)

add_subdirectory(Lib1)
add_subdirectory(Lib2)

# 链接Lib1会自动传递Lib2的依赖，也可以显式加上Lib2
target_link_libraries(${PROJECT_NAME}
    PRIVATE
        lib1
)

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