CMAKE_PROJECT_TOP_LEVEL_INCLUDES

在版本 3.24 中新增。

要包含作為第一個 project() 呼叫一部分的 CMake 語言檔案的以分號分隔的列表。檔案將會在讀取工具鏈檔案（如果已指定）並且設定平台變數後立即包含，但在啟用任何語言之前。因此，特定於語言的變數，包括諸如 CMAKE_<LANG>_COMPILER 之類，可能尚未設定。有關在 project() 呼叫期間可能包含的檔案的更詳細討論，請參閱程式碼注入。

在版本 3.29 中新增：此變數現在也可以參照要在 CMAKE_MODULE_PATH 或 CMake 內建中找到的模組名稱。

此變數旨在指定為組建執行一次性設定的檔案。它為配置套件管理器、新增使用者在專案之間共用的邏輯（例如，定義他們自己的自訂組建類型）等內容提供了一個注入點。它主要供使用者新增特定於其環境的內容，而不是用於指定工具鏈詳細資訊（使用 CMAKE_TOOLCHAIN_FILE）。

預設情況下，此變數為空。它旨在由使用者設定。

另請參閱