CMake中target_include_directories与target_link_libraries的包含目录优先级问题

一、CMake包含目录的核心排序规则 #

CMake对包含目录的优先级排序遵循以下核心逻辑：

• 目标自身通过target_include_directories添加的PRIVATE/PUBLIC目录，会无条件优先于依赖项通过target_link_libraries传递的INTERFACE目录，这与两个命令的调用顺序无关。
• 同一来源的目录（比如都是目标自身添加的），按照调用target_include_directories的先后顺序排列，先添加的目录排在前面。
• 非SYSTEM修饰的目录，优先级高于同来源的SYSTEM修饰目录，但SYSTEM目录依然会优先于依赖传递的INTERFACE目录。

你遇到的问题本质是：prefixA/include是目标自身添加的目录，而prefixB/include是依赖传递的INTERFACE目录，所以无论调整命令顺序，prefixA/include都会排在前面。

二、让prefixB/include优先的解决方案 #

方案1：直接将prefixB/include作为目标自身目录前置添加 #

既然目标自身目录优先级更高，直接把prefixB/include添加为目标的PRIVATE目录，且放在prefixA/include之前：

find_package(SomeTarget REQUIRED)
add_library(mylib source1.cpp)
# 先添加prefixB目录，确保优先级最高
target_include_directories(mylib PRIVATE "${SomeTarget_INCLUDE_DIR}")
# 再添加prefixA目录，保留SYSTEM属性
target_include_directories(mylib SYSTEM PRIVATE prefixA/include)
# 正常链接依赖
target_link_libraries(mylib PRIVATE Some::Target)

方案2：使用target_prepend_include_directories强制前置（CMake 3.19+） #

如果使用CMake 3.19及以上版本，可以用target_prepend_include_directories函数，将指定目录直接插入到包含列表的最前端：

find_package(SomeTarget REQUIRED)
add_library(mylib source1.cpp)
target_include_directories(mylib SYSTEM PRIVATE prefixA/include)
target_link_libraries(mylib PRIVATE Some::Target)
# 将prefixB目录强制放到包含路径的最前面
target_prepend_include_directories(mylib PRIVATE "${SomeTarget_INCLUDE_DIR}")

方案3：从根源指定find_package的查找优先级 #

直接让find_package优先找到prefixB下的包，确保Some::Target本身关联的就是prefixB的目录，同时避免其他路径的干扰：

# 仅针对SomeTarget指定查找根目录，精准定位prefixB
set(SomeTarget_ROOT "prefixB")
find_package(SomeTarget REQUIRED)

add_library(mylib source1.cpp)
target_include_directories(mylib SYSTEM PRIVATE prefixA/include)
target_link_libraries(mylib PRIVATE Some::Target)

这种方式的优势是从依赖源头上解决问题，无需调整目标自身的包含目录，所有通过Some::Target传递的内容都会来自prefixB。

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