include

从文件或模块加载并运行 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。另请参阅策略 CMP0017。

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