CMAKE_IGNORE_PATH

以分號分隔的列表,其中包含各種 find...() 命令要忽略的目錄。

對於 find_program()find_library()find_file()find_path(),在列出的目錄中找到的任何檔案都將被忽略。列出的目錄不會遞迴應用,因此要忽略的任何子目錄也必須明確列出。CMAKE_IGNORE_PATH 不會影響這四個命令使用的搜尋前綴。要忽略搜尋前綴下的個別路徑(例如 binincludelib 等),每個路徑都必須在 CMAKE_IGNORE_PATH 中列為完整絕對路徑。CMAKE_IGNORE_PREFIX_PATH 提供了一種更合適的方法來忽略整個搜尋前綴。

find_package() 也受到 CMAKE_IGNORE_PATH 的影響,但僅適用於 Config 模式 搜尋。在指定目錄中找到的任何 <Name>Config.cmake<name>-config.cmake 檔案都將被忽略。此外,為了向後相容性原因,在 CMAKE_IGNORE_PATH 中找到的任何搜尋前綴都將被跳過,但新程式碼應優先使用 CMAKE_IGNORE_PREFIX_PATH 以改為忽略前綴。

在交叉編譯環境中,當某些系統目錄包含不相容但可能可連結的函式庫時,忽略搜尋位置可能很有用。例如,在交叉編譯的叢集環境中,這允許使用者忽略包含用於前端機器的函式庫的目錄。

預設情況下,CMAKE_IGNORE_PATH 為空。它旨在由專案或最終使用者設定。

另請參見以下變數