CMP0017

當從 CMake 模組目錄包含檔案時，優先使用該目錄中的檔案。

從 CMake 2.8.4 開始，如果隨 CMake 提供的 cmake 模組（即位於 CMake 模組目錄中）呼叫 include() 或 find_package()，則會優先選擇 CMake 模組目錄中的檔案，而非 CMAKE_MODULE_PATH 中的檔案。這確保了屬於 CMake 的模組總是包含它們期望的檔案，並針對這些檔案進行開發和測試。在所有其他情況下，CMAKE_MODULE_PATH 中找到的檔案仍然優先於 CMake 模組目錄中的檔案。OLD 行為是永遠優先選擇 CMAKE_MODULE_PATH 中的檔案，而不是 CMake 模組目錄中的檔案。

此政策在 CMake 版本 2.8.4 中引入。它可以使用 cmake_policy() 或 cmake_minimum_required() 設定。如果未設定，CMake 會發出警告，並使用 OLD 行為。

注意

政策的 OLD 行為依定義已棄用，並可能在未來版本的 CMake 中移除。