CMake中target_include_directories()正确用法及第三方库头文件问题

问题根源 #

你在app的CMake配置里直接链接了my-library.dll二进制文件，而非通过CMake target名称建立依赖关系。CMake的target_include_directories的PUBLIC属性仅通过target间的依赖链传递，直接链接二进制文件时，CMake不会处理该目标的任何PUBLIC/INTERFACE属性（包括头文件路径、编译选项等），因此app无法继承第三方库的头文件路径。

另外，Windows环境下直接链接dll并非标准做法，通常需要链接对应的.lib导入库（MSVC编译场景），不过核心问题仍在于依赖关系的建立方式。

正确处理步骤 #

1. 修正my-library的CMake配置 #

将第三方库包装为IMPORTED target（CMake处理预编译库的标准方式），统一管理其路径与属性：

cmake_minimum_required(VERSION 3.15)

project("my-library" VERSION 0.0.0 LANGUAGES CXX)

set(PUBLIC_HEADERS
    include/my-library.h
)

set(SOURCES
    my-library.cpp
)

add_library("my-library" SHARED ${PUBLIC_HEADERS} ${SOURCES})

# 包装第三方库为IMPORTED target
add_library(third-party SHARED IMPORTED)
set_target_properties(third-party PROPERTIES
    IMPORTED_LOCATION "${CMAKE_SOURCE_DIR}/third-party/third-party.dll"
    # 若存在对应的导入库（如third-party.lib），需添加以下配置
    # IMPORTED_IMPLIB "${CMAKE_SOURCE_DIR}/third-party/third-party.lib"
    INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_SOURCE_DIR}/third-party/include"
)

# 链接第三方库的target，而非直接链接dll
target_link_libraries("my-library" PUBLIC third-party)

# 设置自身头文件路径，PUBLIC模式会传递给依赖my-library的目标
target_include_directories("my-library" PUBLIC 
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
    $<INSTALL_INTERFACE:include> # 安装场景可选配置
)

2. 修正app的CMake配置 #

直接链接my-library这个CMake target，CMake会自动传递所有PUBLIC属性：

# 引入my-library的CMake配置
add_subdirectory(${CMAKE_SOURCE_DIR}/modules/my-library)

add_executable("app" app.cpp) # 替换为你的app源文件

# 直接链接my-library target，无需手动设置其头文件路径
target_link_libraries("app" PRIVATE my-library)

关键要点 #

• 通过CMake target建立依赖：避免直接链接二进制文件，CMake的属性传递完全依赖target间的依赖关系。
• 预编译库用IMPORTED target包装：统一管理库的路径、头文件、编译选项等属性，避免分散配置。
• PUBLIC/INTERFACE属性范围：PUBLIC属性会应用到当前target，同时传递给所有依赖它的target；INTERFACE仅传递给依赖target，不作用于当前target。

额外补充 #

若app与my-library通过独立CMakeLists.txt管理（未使用add_subdirectory），可通过find_package或export/install机制让app找到my-library的target，最直接的方式仍是用add_subdirectory引入my-library的配置。

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