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