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