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