两个子目录引用同一依赖库时如何正确编写CMake文件

只要使用现代CMake（3.0及以上版本，推荐3.10+）的target-based配置方式，完全不会出现重复链接问题。
CMake中通过add_library/add_executable/find_package/add_subdirectory引入的target是全局唯一的，链接阶段CMake会自动对依赖图中的重复target做去重，最终传给链接器的参数里loglib只会出现一次，不会引发静态库重复链接、符号重定义这类问题。
如果使用老旧的目录级命令（比如全局link_libraries、手动拼接库文件路径到LDFLAGS），才可能因为重复传入库路径导致重复链接问题，这类写法本身就不推荐。

核心原则是依赖跟着模块走，用target权限控制传递性，不要全局乱挂依赖：

• 优先在根目录或专门的第三方依赖配置片段中，提前将loglib初始化为全局可用的CMake target：
  • 如果loglib自身提供CMake配置，直接add_subdirectory(external/loglib)即可；
  • 如果是预编译库，就用add_library(loglib STATIC/INTERFACE IMPORTED GLOBAL)配置好对应头文件路径、库文件路径，确保全局可访问。
• 每个子目录的CMakeLists自行管理自身依赖：
  subdir1、subdir2下各自声明自己的库target后，谁依赖loglib就自己在target_link_libraries里声明loglib，根据依赖暴露范围选权限：
  • 如果子模块的头文件没有引用loglib的头文件、类型、接口，loglib只在.cc实现里用，就用PRIVATE链接；
  • 如果子模块的头文件里include了loglib的头，使用loglib的类型作为接口参数/返回值，就用PUBLIC链接，依赖会自动传递给链接该子模块的上层target。
• 根目录只做顶层target的组装：根目录的CMake只需要按顺序add_subdirectory各个子模块，最终给main可执行文件链接subdir1、subdir2两个库即可，不需要关心子模块的内部依赖。

最简正确配置示例：

根目录CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(demo)
# 先引入第三方依赖
add_subdirectory(external/loglib)
# 引入子模块
add_subdirectory(subdir1)
add_subdirectory(subdir2)
# 组装最终可执行文件
add_executable(main main.cc)
target_link_libraries(main PRIVATE subdir1_lib subdir2_lib)

subdir1/CMakeLists.txt（subdir2同理）

add_library(subdir1_lib STATIC a.cc b.cc)
# 子模块自己声明依赖loglib，因为实现用、头文件没暴露，所以用PRIVATE
target_link_libraries(subdir1_lib PRIVATE loglib)
target_include_directories(subdir1_lib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

完全不需要，也绝对不推荐这么做。
把所有依赖都堆到根目录配置，本质是退回到老旧的全局配置写法，会直接破坏模块的自包含性：后续如果要复用subdir1到其他项目、或者调整subdir1的依赖，必须同步修改根目录的配置，模块耦合度极高，维护成本会随着项目规模扩大快速上升。
而用子模块自管依赖的写法，既保留了目录隔离、模块自包含的优势，又靠CMake自身的target依赖去重机制避免了重复链接问题，没有任何额外开销。

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