Back to Cmake

CMAKE_MODULE_PATH

Help/variable/CMAKE_MODULE_PATH.rst

4.3.2893 B
Original Source

CMAKE_MODULE_PATH

:ref:Semicolon-separated list <CMake Language Lists> of directories, represented using forward slashes, specifying a search path for CMake modules to be loaded by the :command:include or :command:find_package commands before checking the default modules that come with CMake. By default it is empty. It is intended to be set by the project.

It's fairly common for a project to have a directory containing various *.cmake files to assist in development. Adding the directory to the :variable:CMAKE_MODULE_PATH simplifies loading them. For example, a project's top-level CMakeLists.txt file may contain:

.. code-block:: cmake

list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")

include(Foo) # Loads ${CMAKE_CURRENT_SOURCE_DIR}/cmake/Foo.cmake

find_package(Bar) # Loads ${CMAKE_CURRENT_SOURCE_DIR}/cmake/FindBar.cmake