CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE

在版本 3.17 中新增。

一個 CMake 語言檔案，將作為任何 project() 命令呼叫的第一步包含進來，該命令呼叫指定 <PROJECT-NAME> 作為專案名稱。這旨在將自訂程式碼注入到專案建置中，而無需修改其原始碼。有關在 project() 呼叫期間可能包含的檔案的更詳細討論，請參閱 程式碼注入。

在版本 3.29 中新增：此變數可以是 CMake 語言檔案的以分號分隔的列表，這些檔案將依序包含進來。它現在還可以指模組名稱，這些模組名稱可以在 CMAKE_MODULE_PATH 或作為內建的 CMake 模組中找到。

另請參閱 CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE、CMAKE_PROJECT_INCLUDE、CMAKE_PROJECT_INCLUDE_BEFORE 和 CMAKE_PROJECT_TOP_LEVEL_INCLUDES 變數。