cmake target_include_directories 详解

在 CMake 中，target_include_directories 命令用于向特定目标（如可执行文件或库）添加包含目录，以便编译器能够找到特定目标所需的头文件。

基本语法

target_include_directories(target_name
    [SYSTEM] [BEFORE]
    directory1
    [directory2 ...]
)

• target_name：目标名称，可以是通过 add_executable 或 add_library 定义的可执行文件或库的名称。
• SYSTEM：可选参数，用于将指定的目录标记为系统包含目录，避免编译器产生警告。
• BEFORE：可选参数，将指定的目录添加到已有的包含目录前面。
• directory1, directory2, …：要添加到目标的包含目录列表。这些可以是绝对路径或相对于
  CMakeLists.txt 文件的相对路径。

示例用法
假设你的项目目录结构如下：

project/
├── CMakeLists.txt
├── src/
│   ├── main.cpp
│   ├── file1.cpp
│   └── file2.cpp
└── include/
    └── header.h

以下是一个示例 CMakeLists.txt 文件，演示了如何使用 target_include_directories 将 include 目录添加到 MyExecutable 目标中：

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 设置 C++ 标准
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED True)

# 添加可执行文件
add_executable(MyExecutable
    src/main.cpp
    src/file1.cpp
    src/file2.cpp
)

# 添加包含目录
target_include_directories(MyExecutable PUBLIC
    include
)

# 查找第三方库 LibXYZ
find_package(LibXYZ REQUIRED)

# 将 LibXYZ 的包含目录添加到 MyExecutable 目标中
target_include_directories(MyExecutable PRIVATE
    ${LibXYZ_INCLUDE_DIRS}
)

# 设置第三方库 LibXYZ 的路径
set(LibXYZ_INCLUDE_DIRS "/path/to/LibXYZ/includes")

# 将 LibXYZ 的包含目录添加到 MyExecutable 目标中
target_include_directories(MyExecutable PRIVATE
    ${LibXYZ_INCLUDE_DIRS}
)

注意事项

1. 包含目录：
   • 使用 target_include_directories 命令来指定要添加到目标的包含路径。
   • 在示例中，通过 PUBLIC 关键字将 include 目录添加为 MyExecutable 目标的公共包含目录。这意味着MyExecutable 及其依赖项（如果有）都可以访问这些头文件。
2. 多目录添加：
   • 可以将多个目录添加到 target_include_directories 命令中，以列出所有需要的包含路径。
3. 路径类型：
   • 目录可以是绝对路径或相对于 CMakeLists.txt 文件的相对路径。
4. 影响范围：
   • 使用 PUBLIC、PRIVATE 或 INTERFACE 关键字可以控制包含路径的传递性，详细说明如下：
     • PUBLIC：包含目录将传递给目标和目标的用户。
     • PRIVATE：包含目录仅传递给目标本身。
     • INTERFACE：包含目录仅传递给目标的用户。

通过正确配置包含目录，可以确保编译器能够正确找到和包含项目中需要的头文件，这对于构建和管理大型项目尤为重要。