包括

从文件或模块加载并运行 CMake 代码。

include(<file|module> [OPTIONAL] [RESULT_VARIABLE <var>]
                      [NO_POLICY_SCOPE])

从给定的文件加载并运行 CMake 代码。变量读取和写入访问调用者的范围(动态范围)。如果存在“OPTIONAL”,那么如果文件不存在则不会引发错误。如果给出了 RESULT_VARIABLE,变量 <var>` 将被设置为已包含的完整文件名,如果失败则为 NOTFOUND`

如果指定了模块而不是文件,则首先在 CMAKE_MODULE_PATH 中搜索名为 <modulename>.cmake 的文件,然后在 CMake 模块目录中搜索。有一个例外:如果调用 include() 的文件本身位于 CMake 内置模块目录中,则首先搜索 CMake 内置模块目录,然后搜索 CMAKE_MODULE_PATH。另请参阅政策:policy:CMP0017

有关 NO_POLICY_SCOPE 选项的讨论,请参阅 cmake_policy() 命令文档。