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 版本 |发布|当未设置策略并使用“旧”行为时发出警告。使用 cmake_policy() 命令将其显式设置为 OLD 或 NEW。

备注

策略的“旧”行为是 :manual:根据定义 <cmake-policies(7)> 已弃用，并且可能会在未来版本的 CMake 中删除。