CMake Difference between include_directories and add_subdirectory?

在CMake中，include_directories和add_subdirectory是两个非常常用但功能截然不同的命令。以下是这两个命令的主要区别及用途：

1. include_directories

include_directories命令用于向项目添加头文件搜索路径。该命令告诉编译器在编译时应在哪些目录中查找头文件。这对于项目中的所有目标文件都是全局的，除非特别指定范围。

例子： 假设你有一个项目，项目中有一些共享的头文件存放在include目录下，你可以使用以下命令将其添加到搜索路径中：

cmake
include_directories(${CMAKE_SOURCE_DIR}/include)

这样，CMake 会在编译时自动在include目录下搜索需要包含的头文件。

2. add_subdirectory

add_subdirectory命令用于向当前项目添加子目录，这个子目录中应该包含它自己的CMakeLists.txt文件。这对于将大型项目分解成小的、更易于管理的模块非常有用。当执行add_subdirectory时，CMake 会进入指定的子目录，执行那里的CMakeLists.txt，从而允许构建在该子目录中定义的目标。

例子： 假设你的项目结构中有一个名为lib的目录，里面有一个库的代码和它自己的CMakeLists.txt文件。你可以通过以下命令将其添加到主项目中：

cmake
add_subdirectory(lib)

这将使得在lib目录中定义的所有目标（如库）都将被构建，并且可以被项目中的其他部分使用。

总结

简而言之，include_directories用于添加头文件的搜索路径，使得编译器能找到这些头文件，而add_subdirectory用于添加包含自己CMakeLists.txt的子目录，这些子目录可能包含要构建的目标（如库或可执行文件）。这两者都是项目组织中不可或缺的工具，但它们的用途和影响是完全不同的。