CMake中的include函数

2023年12月5日，周二晚上

---

在 CMake 中，include 函数用于包含其他 CMake 脚本文件。

include 函数的语法如下：

include(filename [OPTIONAL] [RESULT_VARIABLE var] [NO_POLICY_SCOPE])

其中，filename 表示要包含的脚本文件的路径。路径可以是相对路径或绝对路径。如果文件名不包含路径分隔符，则 CMake 会搜索 CMake 模块路径和当前源代码目录来查找该文件。

可选的参数包括：

• OPTIONAL：可选参数，表示如果文件不存在也不会产生错误。
• RESULT_VARIABLE var：可选参数，将结果存储在变量 var 中。
• NO_POLICY_SCOPE：可选参数，指定包含的文件在策略范围内运行。

当执行 include 函数时，CMake 将加载并执行指定的脚本文件。这意味着脚本文件中的所有命令和变量定义都将在当前脚本中生效。

通常，include 函数用于将共享的 CMake 模块或其他功能性脚本文件包含到主要的 CMakeLists.txt 文件中，以实现代码的重用和模块化。

以下是一个示例，演示如何使用 include 函数包含一个名为 "my_functions.cmake" 的脚本文件：

include(my_functions.cmake)

如果脚本文件位于不同的目录中，可以使用相对或绝对路径来指定文件的位置。例如：

include(subdirectory/my_functions.cmake)
include(/path/to/my_functions.cmake)