CMAKE_IGNORE_PATH¶
各個 find...()
命令要忽略的目錄的分號分隔列表。
對於 find_program()
、 find_library()
、 find_file()
和 find_path()
,在列出的目錄中找到的任何檔案都將被忽略。列出的目錄不適用於遞迴,因此任何要忽略的子目錄也必須明確列出。 CMAKE_IGNORE_PATH
不會影響這四個命令使用的搜尋前綴。若要忽略搜尋前綴下的個別路徑(例如 bin
、 include
、 lib
等),則必須在 CMAKE_IGNORE_PATH
中將每個路徑列為完整的絕對路徑。 CMAKE_IGNORE_PREFIX_PATH
提供了一種更適當的方式來忽略整個搜尋前綴。
find_package()
也會受到 CMAKE_IGNORE_PATH
的影響,但僅適用於設定檔模式搜尋。 在指定的目錄中找到的任何 <Name>Config.cmake
或 <name>-config.cmake
檔案都將被忽略。 此外,出於向後相容性的原因,將會跳過在 CMAKE_IGNORE_PATH
中找到的任何搜尋前綴,但新程式碼應優先使用 CMAKE_IGNORE_PREFIX_PATH
來忽略前綴。
在交叉編譯環境中,某些系統目錄包含不相容但可能可連結的程式庫時,忽略搜尋位置會很有用。 例如,在交叉編譯的叢集環境中,這允許使用者忽略包含用於前端機器的程式庫的目錄。
預設情況下,CMAKE_IGNORE_PATH
是空的。 它旨在由專案或終端使用者設定。
另請參閱以下變數