CMAKE_PROJECT_TOP_LEVEL_INCLUDES

新增於版本 3.24。

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

新增於版本 3.29：此變數現在也可以引用模組名稱，這些模組名稱將在 CMAKE_MODULE_PATH 或 CMake 內建模組中找到。

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

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

參見