CMake中如何让依赖库自动传递被依赖库的公共头目录

嘿，这个场景在CMake项目里太常见了——要让依赖库B的应用自动拿到库A的头文件目录，不用手动在应用里加路径，核心就是用好CMake的目标属性传递机制，具体来说就是target_include_directories和target_link_libraries里的PUBLIC/INTERFACE关键字。

我结合你提到的示例（library_foo、library_bar、第三方应用）来一步步说明：

1. 先正确配置library_foo的头文件目录 #

首先，library_foo需要把自己的公共头文件目录标记为PUBLIC，这样任何依赖它的目标（比如library_bar）都能自动继承这个目录。

假设library_foo的结构是：

library_foo/
├── include/
│   └── foo.h
├── foo.cpp
└── CMakeLists.txt

它的CMakeLists.txt应该这么写：

add_library(library_foo SHARED
    foo.cpp
)

# 把公共头目录设置为PUBLIC：自己能用，依赖它的目标也能自动拿到
target_include_directories(library_foo
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/include
)

2. 配置library_bar，传递foo的依赖 #

library_bar的公共头文件引用了foo的头文件，所以它需要把对library_foo的依赖传递给后续的应用。假设library_bar的结构：

library_bar/
├── include/
│   └── bar.h  # 里面#include <foo.h>
├── bar.cpp
└── CMakeLists.txt

它的CMakeLists.txt关键配置：

add_library(library_bar SHARED
    bar.cpp
)

# 先设置自己的公共头目录为PUBLIC
target_include_directories(library_bar
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/include
)

# 链接library_foo时用PUBLIC：这样依赖library_bar的应用会自动继承foo的头目录和链接关系
target_link_libraries(library_bar
    PUBLIC
        library_foo
)

这里的PUBLIC是核心：它告诉CMake，library_bar的公共接口依赖于library_foo，所以任何使用library_bar的目标（比如你的应用）都需要知道library_foo的存在，包括它的头文件目录。

3. 第三方应用只需依赖library_bar #

最后，应用的CMakeLists.txt只需要链接library_bar，不用管library_foo的头文件路径——CMake会自动把library_foo的公共头目录传递过来：

add_executable(my_app
    main.cpp  # 里面#include <bar.h>，而bar.h已经引用了foo.h，无需手动加foo的路径
)

# 只需要链接library_bar，自动获取bar和foo的所有公共头目录
target_link_libraries(my_app
    PRIVATE
        library_bar
)

关键原理总结 #

• PUBLIC：会把目标的属性（头文件目录、编译选项等）同时传递给目标自身和所有依赖该目标的目标。
• INTERFACE：仅传递给依赖该目标的目标，目标自身不使用这些属性。
• 一定要避免用全局的include_directories，这种方式会污染所有目标，而基于目标的配置是现代CMake的最佳实践，更清晰也更易维护。

额外提醒：如果library_bar只是在.cpp实现文件里用到library_foo，而公共头文件里没引用，那可以把target_link_libraries里的PUBLIC换成PRIVATE——这样应用就不会继承library_foo的头目录，因为它不需要。

内容的提问来源于stack exchange，提问作者Tibor Takács