CMake target_link_libraries PUBLIC链接依赖传递规则咨询

以下分析基于你提供的implot项目CMake配置片段：

# ...

add_library(imgui ${IMGUI_HEADERS} ${IMGUI_SRC})
if(MSVC)
  target_compile_options(imgui PRIVATE /W4 /WX /arch:AVX2 /fp:fast)
endif()
target_link_libraries(imgui PUBLIC glfw glad OpenGL::GL imm32)
target_compile_definitions(imgui PRIVATE IMGUI_DLL_EXPORT)

# ...

add_library(implot ${IMPLOT_HEADERS} ${IMPLOT_SRC})
target_link_libraries(implot PUBLIC imgui)
target_compile_definitions(implot PUBLIC IMPLOT_DEBUG IMPLOT_DLL_EXPORT IMPLOT_BACKEND_ENABLE_OPENGL3 IMGUI_IMPL_OPENGL_LOADER_GLAD)
set_property(TARGET implot PROPERTY CXX_STANDARD 11)
if(MSVC)
  target_compile_options(implot PRIVATE /W4 /WX /arch:AVX2 /fp:fast /permissive-) 
else()
  target_compile_options(implot PRIVATE -Wall -Wextra -pedantic -Werror -mavx2 -Ofast)
endif()

问题1解答 #

glfw、glad、OpenGL::GL、imm32这几个依赖会按照CMake规则自动向上传递，但不是所有使用implot的构建目标都会以PUBLIC级别继承这些依赖：

• target_link_libraries的PUBLIC关键字有两层作用：一是标记的依赖会参与当前目标自身的编译链接，和PRIVATE效果一致；二是这些依赖会被写入当前目标的接口依赖属性，所有链接当前目标的上层目标都会自动继承这些依赖的完整配置，包括链接项、头文件搜索路径、关联编译定义等。
• 这套配置的实际传递链路：
  • imgui以PUBLIC方式链接glfw等四个依赖，这四个依赖会进入imgui的接口依赖列表
  • implot以PUBLIC方式链接imgui，会自动把imgui接口列表里的所有依赖继承过来，写入implot自身的接口依赖列表
  • 任何链接implot的目标，不管是可执行文件还是其他库，都不需要手动重复配置链接这四个库，CMake会自动补全对应的依赖配置
• 注意依赖的传递范围不是固定PUBLIC：如果上层目标用PRIVATE方式链接implot，那这四个依赖只会在该上层目标的编译链接阶段生效，不会继续往更上层的目标传递；只有上层目标用PUBLIC方式链接implot时，这些依赖才会继续向上传递。

问题2解答 #

这个依赖传递特性和imgui是不是共享库没有任何关系，是CMake目标模型的原生机制：

• 不管构建目标是静态库（STATIC）、共享库（SHARED）、对象库（OBJECT）还是纯头文件的接口库（INTERFACE），只要配置了PUBLIC或INTERFACE级别的链接项、编译选项、头文件搜索路径等属性，这些属性都会按照规则向上传递，和库的二进制类型完全无关。
• 你贴的配置里add_library没有显式指定库类型，最终编译出静态库还是动态库由CMake全局的BUILD_SHARED_LIBS开关决定，但这个选择不会改变依赖传递的逻辑。
• 这里纠正一个常见误区：很多人以为只有静态库需要传递依赖，实际上哪怕imgui编译成共享库，只要它的公开头文件里用到了glfw、glad相关的类型、宏定义，上层目标编译阶段依然需要拿到这些依赖的头文件路径、编译宏配置，CMake的自动传递机制就是为了省掉逐层手动配置依赖的重复工作，避免漏配导致的编译、链接错误。

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