CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE

在版本 3.17 中新增。

一个 CMake 语言文件，在任何指定 <PROJECT-NAME> 作为项目名称的 project() 命令调用中，作为第一步被包含。这旨在将自定义代码注入到项目构建中，而无需修改其源代码。有关 project() 调用期间可能包含的文件的更详细讨论，请参阅 代码注入。

在版本 3.29 中新增：此变量可以是一个 分号分隔的列表，包含要顺序包含的 CMake 语言文件。它现在也可以引用模块名称，这些模块名称可以在 CMAKE_MODULE_PATH 中找到，或者作为内置的 CMake 模块。

另请参阅 CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE, CMAKE_PROJECT_INCLUDE, CMAKE_PROJECT_INCLUDE_BEFORE, 和 CMAKE_PROJECT_TOP_LEVEL_INCLUDES 变量。