拆分CMakeLists.txt为子目录后导入库无报错且包含目录失效

提出的问题 #

1. 为何在子目录中使用target_include_directories时，不存在的路径无报错？
2. 为何target_include_directories被忽略时无警告？
3. 为何使用add_subdirectory时target_include_directories会被忽略？

解答 #

1. 子目录中无效路径无报错的原因 #

CMake对target_include_directories的路径检查逻辑和目标是否被“消费”直接相关。单文件配置里，pglib和依赖它的bar在同一作用域，配置阶段CMake会立即验证INTERFACE路径的有效性；但拆分到子目录后，lib子目录定义pglib时，当前作用域没有直接使用它的目标（bar在另一个子目录），CMake默认不会主动检查未被引用的INTERFACE路径。只有当编译阶段bar真正尝试使用这些路径时才会发现问题，但此时配置阶段已经结束，所以配置时不会报错。

2. target_include_directories被忽略无警告的原因 #

CMake默认不会对未生效的INTERFACE属性发出警告。INTERFACE类型的属性只有在目标被其他目标链接时才会触发传递，如果因为作用域等问题导致属性没被传递，CMake不会主动提示。除非手动开启特定诊断选项，否则不会收到相关警告。

3. add_subdirectory导致属性被忽略的原因 #

核心问题是导入目标的作用域限制：
通过add_library(... SHARED IMPORTED)创建的导入目标默认是LOCAL作用域，仅在定义它的子目录（也就是lib目录）及其子目录内有效。当postgres_test子目录的bar目标尝试链接pglib时，CMake不会传递LOCAL导入目标的INTERFACE属性（包括头文件路径、链接目录等），导致这些属性被忽略。

而单文件配置中所有目标处于同一作用域，不存在跨作用域传递的限制，所以属性能正常生效。解决方法是在lib/CMakeLists.txt中给pglib添加全局作用域属性：

# 方法1：创建时直接声明GLOBAL
add_library(pglib SHARED IMPORTED GLOBAL)

# 方法2：通过set_target_properties设置
set_target_properties(pglib PROPERTIES IMPORTED_GLOBAL TRUE)

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