include_directories()是全局作用域,影响所有后续target;target_include_directories()是目标级、支持PUBLIC/PRIVATE/INTERFACE作用域的现代推荐写法,可精准控制头文件路径的可见性与依赖传递。

include_directories() 和 target_include_directories() 有什么区别?
include_directories() 是全局作用域,所有后续定义的 target 都会继承这些头文件路径;而 target_include_directories() 是 target 级别、精确控制依赖范围的现代写法。CMake 3.0+ 官方推荐后者,避免隐式污染和构建错误。
- 全局路径容易导致不同 target 互相干扰,尤其在多 target 项目中
-
target_include_directories()支持PUBLIC/PRIVATE/INTERFACE语义:比如你用add_library(mylib)并希望它的头文件被链接它的 target 找到,就得用PUBLIC -
PRIVATE表示只本 target 编译时需要,不传递给依赖者;INTERFACE表示只提供头文件,不参与编译(常用于 header-only 库)
例如:
add_library(mylib src/a.cpp)
target_include_directories(mylib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)
target_include_directories(mylib PRIVATE ${CMAKE_CURRENT_BINARY_DIR})
怎么让头文件路径对子目录生效?
CMake 的 include 路径不会自动继承到 add_subdirectory() 的子目录,除非显式传递或使用 target_include_directories() 的 INTERFACE 属性向上暴露。
- 如果子目录里的 target 需要父目录的头文件,不要在子
CMakeLists.txt里重复写target_include_directories(),而是让父 target 把路径设为INTERFACE,再用target_link_libraries()传导 -
include_directories()在父目录调用后,子目录的 target 仍能用——但这属于“副作用”,不可靠且难以维护 - 更稳妥的做法:在父 target 上设置
PUBLIC或INTERFACE,然后子 target 通过target_link_libraries(child_target PRIVATE parent_target)自动获得其头路径
第三方库头文件路径怎么加进 target?
直接把第三方库的 include 路径硬编码进 target_include_directories() 是常见做法,但容易出错;更健壮的方式是用 find_package() + 导出的 INTERFACE_INCLUDE_DIRECTORIES 属性。
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
- 比如
find_package(OpenCV REQUIRED)后,target_link_libraries(myapp PRIVATE opencv_core opencv_imgproc)就自动带入头路径,无需手动加 - 若没有
find_package支持(如自建库),可先add_library(thirdparty INTERFACE),再用target_include_directories(thirdparty INTERFACE /path/to/headers),最后target_link_libraries(myapp PRIVATE thirdparty) - 错误写法:
target_include_directories(myapp PRIVATE /usr/local/include/xxx)—— 这种路径不跨平台,也不适配 install layout
为什么头文件找到了却报 “no such file or directory”?
常见原因不是路径没设,而是 include 写法和路径设置不匹配。
-
#include "foo.h"搜索顺序优先当前源文件所在目录,再按target_include_directories()列表顺序找;而#include跳过当前目录,只走 include 路径 - 如果你写了
#include "subdir/foo.h",那target_include_directories()应该指定到include目录本身,而不是include/subdir - CMake 默认不处理 Windows 和 Linux 路径分隔符差异,用
${CMAKE_CURRENT_SOURCE_DIR}/include比硬写./include或include\更安全
路径层级和 include 写法必须对齐,这是最常被忽略的一环。










