CMAKE_PROJECT_TOP_LEVEL_INCLUDES

在 3.24 版本中添加。

用分号分隔的列表需要作为第一个 project() 调用的组成部分的 CMake 语言文件。这些文件将在工具链文件读取完成（如果指定了的话）且平台变量已设置，但启用任何语言之前，立刻包括进来。因此，特定语言变量（包括诸如 CMAKE_<LANG>_COMPILER 等内容）可能没有设置。参阅 代码注入 以详细了解在 project() 调用期间可能包括的文件。

在 3.29 版本中添加： 该变量现在还可以引用 CMAKE_MODULE_PATH 中需要查找的模块名称或 CMake 中的内置模块。

该变量旨在指定对构建的一次性设置执行的文件。它提供了一个注入点，用于配置程序包管理器、添加用户共享于项目之间的逻辑（例如定义他们自己的自定义构建类型），等等。它主要用于用户添加对其环境来说特定内容，而不是指定工具链的详细信息（为此，使用 CMAKE_TOOLCHAIN_FILE）。

这个变量默认为空。用户需要进行设置。

另请参阅

• CMAKE_PROJECT_INCLUDE

• CMAKE_PROJECT_INCLUDE_BEFORE

• CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE

• CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE

• PROPAGATE_TOP_LEVEL_INCLUDES_TO_TRY_COMPILE