CMake中target_include_directories报错，include_directories却正常的问题

你的问题核心在于对CMake中INTERFACE属性作用范围的误解，以及目标配置的时机问题，以下是具体分析和修复方案：

为什么移除全局include_directories会报错？ #

target_include_directories(... INTERFACE)的作用是将包含路径传递给依赖该目标的其他目标，而非作用于目标自身。如果LIB_NET_COMMONS是一个包含头文件的目标（哪怕是仅头文件库），当CMake处理它的头文件引用（比如#include <jwt-cpp/jwt.h>）时，自身需要能找到这些路径，但INTERFACE属性不会为目标本身添加包含路径。

而全局include_directories会给所有目标添加包含路径，所以之前能正常工作，但这确实不符合按需配置的最佳实践。

修复步骤 #

1. 正确定义仅头文件库目标 #

如果LIB_NET_COMMONS是纯头文件库，应该将其定义为INTERFACE类型（而非STATIC或SHARED），这样所有配置都会直接传递给依赖它的目标。修改Source目录下的CMakeLists.txt：

# 定义为INTERFACE类型的仅头文件库
add_library(${LIB_NET_COMMONS} INTERFACE)

# 配置目标的包含路径：
# - 当前目录：让依赖目标能找到lib.h
# - jwt-cpp的include目录：满足lib.h中对jwt头文件的引用
# - openssl的include目录：jwt-cpp依赖openssl，需传递给依赖目标
target_include_directories(${LIB_NET_COMMONS} INTERFACE
    ${CMAKE_CURRENT_SOURCE_DIR}
    ${PROJECT_SOURCE_DIR}/External/jwt/include
    /opt/local/libexec/openssl3/include
)

# 链接jwt-cpp库，INTERFACE会将链接依赖传递给下游目标
target_link_libraries(${LIB_NET_COMMONS} INTERFACE jwt-cpp)

# 传递C++20标准要求给下游目标
target_compile_features(${LIB_NET_COMMONS} INTERFACE cxx_std_20)

2. 清理顶层CMake配置 #

移除顶层CMakeLists.txt中的全局包含路径：

# 删除这两行
# include_directories(External/jwt/include)
# include_directories(/opt/local/libexec/openssl3/include)

3. 确保依赖目标正确链接 #

检查Executables等依赖LIB_NET_COMMONS的目标，是否通过target_link_libraries正确链接该库：

# 示例：可执行目标链接LIB_NET_COMMONS
add_executable(my_exec main.cpp)
target_link_libraries(my_exec PRIVATE ${LIB_NET_COMMONS})

额外注意事项 #

• 确保External目录下的CMakeLists.txt正确引入了jwt-cpp的CMake目标（比如通过add_subdirectory(jwt)，前提是jwt目录包含jwt-cpp官方的CMakeLists.txt），这样jwt-cpp自身的依赖会被自动处理。
• 避免全局配置（如include_directories、link_libraries），优先使用目标专属的配置，保持CMake工程的模块化和可维护性。

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