基础命令include_directories()
6. include_directories
6.1 命令格式:
include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])
include_directories用于指定包含头文件目录。include_directories函数允许在CMakeLists.txt文件中指定项目的头文件目录，以便在编译过程中能够正确地找到和包含目录中的头文件。
6.2 参数说明
- BEFORE | AFTER：可选参数，它们用于指定包含目录的添加顺序。如果使用AFTER修饰符，那么添加的目录将会放在已有包含目录的后面；如果使用BEFORE修饰符，那么添加的目录将会放在已有包含目录的前面。默认情况下，新的包含目录会放在已有目录的后面。
- SYSTEM：是一个可选的修饰符，用于指定所包含的目录是系统级别的目录。当使用SYSTEM修饰符时，编译器会将这些目录视为系统级别的头文件目录，这意味着编译器不会产生关于这些目录的警告信息。
6.3 示例
假设我们的项目依赖一个名为"foo.h"的头文件，该头文件的路径为"/path/to/foo.h"。我们可以使用include_directories命令将该路径添加到编译器的搜索路径中，示例代码如下：
include_directories(/path/to)
这样一来，编译器就能够在指定的目录中查找名为"foo.h"的头文件。
此外，你也可以一次添加多个查找目录：
include_directories(
directory1
directory2
directory3
...
)
在这个示例中，我们使用include_directories命令一次性添加了目录directory1、directory2和directory3。你可以根据需要添加更多的目录路径。
6.4 注意事项
- include_directories命令应该在add_executable或add_library之前使用，以确保编译器在构建过程中能够找到所需的头文件。
- include_directories命令仅仅告诉编译器在哪些目录中查找头文件，并不会自动包含这些头文件。要包含头文件，需要使用#include预处理指令在代码中显式包含。
- 尽量避免使用include_directories命令的绝对路径。推荐使用相对于CMakeLists.txt文件的相对路径，以增加项目的可移植性。
- 在使用include_directories命令时，应确保指定的目录中包含正确的头文件。否则，编译器可能无法找到所需的头文件，导致编译错误。
推荐使用target_include_directories而不是include_directories 原因如下：
-
更明确的作用域：include_directories命令是全局性的，它将全局添加的目录路径应用于整个项目。这可能导致潜在的命名冲突或不必要的搜索路径。而target_include_directories命令是针对特定目标（例如可执行文件或库）的，它可以将目录路径限定在特定的目标范围内，提供了更明确的作用域控制。
-
更好的可维护性：通过使用target_include_directories命令，可以将目录路径与特定的目标关联起来。这样，在添加、修改或删除目标时，与之相关的目录路径也会自动调整，保持代码的一致性和可维护性。而使用include_directories命令时，需要手动确保目录路径的一致性，增加了维护工作的复杂性。
-
更好的依赖管理：target_include_directories命令可以与target_link_libraries命令结合使用，以确保正确的头文件搜索路径传递给依赖的目标。这样，在构建库时，库的用户不需要手动添加依赖的头文件路径，而是通过依赖关系自动传递。这简化了项目的依赖管理。
-
跨平台兼容性：在某些情况下，使用target_include_directories命令可以提供更好的跨平台兼容性。例如，在使用一些编译器或构建工具链时，target_include_directories命令可以更好地处理特定的平台或编译器标志，以确保正确的头文件搜索路径。
附：返回总目录的传送门如下:
〓〓〓〓〓〓〓〓踏实学CMake总目录〓〓〓〓〓〓〓〓〓〓