include

從檔案或模組載入並執行 CMake 程式碼。

include(<file|module> [OPTIONAL] [RESULT_VARIABLE <var>]
                      [NO_POLICY_SCOPE])

從給定的檔案載入並執行 CMake 程式碼。變數的讀寫會存取呼叫者的範圍（動態作用域）。如果存在 OPTIONAL，則當檔案不存在時不會引發錯誤。如果給定了 RESULT_VARIABLE，變數 <var> 將被設定為已包含的完整檔案名稱，如果失敗則設定為 NOTFOUND。

如果指定的是模組而不是檔案，則會先在 CMAKE_MODULE_PATH 中搜尋名為 <modulename>.cmake 的檔案，然後在 CMake 模組目錄中搜尋。有一個例外：如果呼叫 include() 的檔案本身位於 CMake 內建模組目錄中，則會先搜尋 CMake 內建模組目錄，然後再搜尋 CMAKE_MODULE_PATH。另請參閱政策 CMP0017。

有關 NO_POLICY_SCOPE 選項的討論，請參閱 cmake_policy() 命令文件。