CMAKE_PROJECT_TOP_LEVEL_INCLUDES¶
版本 3.24 新增。
分号分隔的列表，其中包含 CMake 语言文件，这些文件将作为首次 project() 调用的组成部分包含进来。这些文件将在工具链文件（如果已指定）读取之后和平台变量设置之后立即包含，但在启用任何语言之前。因此，语言相关的变量，包括诸如 CMAKE_<LANG>_COMPILER 之类的变量，可能尚未设置。有关在 project() 调用期间可能包含的文件的更详细讨论，请参阅 代码注入。
版本 3.29 新增：此变量现在还可以引用模块名称，这些模块名称可以在 CMAKE_MODULE_PATH 或 CMake 内置模块中找到。
此变量旨在用于指定为构建执行一次性设置的文件。它为诸如配置包管理器、添加用户在项目之间共享的逻辑（例如，定义他们自己的自定义构建类型）等内容提供了一个注入点。它主要供用户添加特定于其环境的内容，而不是用于指定工具链详细信息（为此，请使用 CMAKE_TOOLCHAIN_FILE）。
默认情况下，此变量为空。它旨在由用户设置。
参见