target_include_directories 的作用和使用方法

最新推荐文章于 2025-06-14 12:37:49 发布

原创

最新推荐文章于 2025-06-14 12:37:49 发布 · 3.3k 阅读

CC 4.0 BY-SA版权

文章标签：

target_include_directories命令在CMake中用于为特定的目标（如可执行文件或库）指定包含（头文件）目录。这些指定的目录在编译时会被添加到编译器的搜索路径中，使得编译器可以找到目标的源文件包含的头文件。

当项目包含多个目录，并且源文件在不同目录下分布时，target_include_directories能够帮助编译器找到这些分散的头文件。这对于保持项目的组织结构清晰、解决头文件依赖问题非常有用。

target_include_directories的基本语法如下：

target_include_directories(<target>
  [BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

<target>: 目标的名称，可以是可执行文件或库。
BEFORE: 可选关键字，指定包含目录应该在默认目录之前被添加到编译器的搜索路径。
<INTERFACE|PUBLIC|PRIVATE>: 指定包含目录的范围：
- PRIVATE: 目录仅对该目标可见，不会影响依赖该目标的其他目标。
- INTERFACE: 目录不会添加到该目标的编译选项中，但会添加到链接该目标的其他目标中。
- PUBLIC: 目录既会添加到该目标的编译选项中，也会添加到链接该目标的其他目标中。