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 的影響,但僅適用於設定檔模式搜尋。 在指定的目錄中找到的任何 <Name>Config.cmake<name>-config.cmake 檔案都將被忽略。 此外,出於向後相容性的原因,將會跳過在 CMAKE_IGNORE_PATH 中找到的任何搜尋前綴,但新程式碼應優先使用 CMAKE_IGNORE_PREFIX_PATH 來忽略前綴。

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

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

另請參閱以下變數