CMAKE_PROJECT_TOP_LEVEL_INCLUDES¶

在 3.24 版本加入.

CMake 语言文件的分号分隔列表 <CMake 语言列表>，作为第一个 project() 调用的一部分。在读取工具链文件（如果已指定）并设置平台变量后，但在启用任何语言之前，将立即包含这些文件。因此，可能不会设置特定于语言的变量，包括 CMAKE_<LANG>_COMPILER 之类的东西。有关在 project() 调用期间可能包含的文件的更详细讨论，请参阅代码注入。

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